Merge authoritative main into the task branch
Why: include the current integration baseline before verification. Evidence: fetched origin/main=7e6c544b3c25c510e3d928bfb4515937a1cd6696. Impact: integrate upstream changes without rewriting task history. Refs: task-sync
This commit is contained in:
File diff suppressed because one or more lines are too long
@@ -0,0 +1,410 @@
|
||||
# feature/cli-agent-fallback-chain 任务卡
|
||||
|
||||
任务主记录：PR #648 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/648；状态：已完成（合入前闭合）；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= d2035c76dc1cb15e01d2c184af5155d9d773cd9f
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain（worktree）；分支：feature/cli-agent-fallback-chain
|
||||
- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
|
||||
- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=8817d4906061c95f5116cecb7e6b185dc6882b638ea71d2dde2db6e437903610；triage_receipt=/tmp/cli-fallback-chain-triage.json；receipt_sha256=555d302ea9cc489bc4b9ef51c0c5857332df08494cd57267646f93c1eabfaf7b
|
||||
|
||||
- 授权与交付终点：用户 2026-10-20 要求修改执行规范：CLI Agent 安全失败后不询问用户、自动换下一候选；候选为 cursor(auto)、agy(Gemini 3.8 Flash)、pi(GLM-5.3-flash)、pi(MiniMax-M3)，前三类顺序不限，Codex(GPT-6.1-Sol) 必须最后；每候选 3 次，全部失败后暂停询问是否重试。授权范围内实施、验证、Review、PR 合入 Dev main 与安全收口。不改 DM 控制器、不部署、不发布版本、不改分支保护。
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段：实施与自检；当前增量：I1（AGENT-EXECUTION.md 候选链 + 规范文字）
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
目标：`AGENT-EXECUTION.md` 的四个角色候选均为 cursor(`auto`)、antigravity(`gemini-3.8-flash-high`)、pi-glm(`zai-coding-cn/glm-5.3-flash`)、pi(`minimax-cn/MiniMax-M3`)，codex(`gpt-6.1-sol`) 固定为最后候选；去掉 `emergency_profile`，`max_attempts_per_profile: 3` 对含 Codex 在内的每个候选生效。`policy/delivery.md`、`policy/governance.md`、`policy/tool-adaptation-matrix.md` 同步：安全可恢复失败自动换候选、不询问用户；Codex 之外的候选顺序可按角色调整但 Codex 必须最后；全部安全耗尽后 host 暂停并询问用户是否重试，仍不代写。
|
||||
|
||||
验收：`make agent-exec-validate` 通过；文档与机器块一致；PR HEAD 完整 CI 通过。
|
||||
|
||||
非目标：不改 DM 控制器（不实现运行时随机顺序；“顺序不限”由声明顺序满足）；fail-stop 终态（`failed-unknown` 等）语义不变；不改 `deps/development-guidelines`。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| dev-cli-agent-fallback-chain | `AGENT-EXECUTION.md`、`policy/{delivery,governance,tool-adaptation-matrix}.md` | config_digest=d2e3574ebf5a…（run 时 AGENT-EXECUTION.md 为 R0 版本） | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable / auto | completed (success) | refs/agent-exec/68343647…/536ff962e681 → 8e21b66db4606c20a1d7de4f1293fbcd61780658 | 否 | /tmp/cli-fallback-chain-receipt.json（单元包 /tmp/cli-fallback-chain-unit.json） |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态：不适用（用户直接提出的执行路由调整，无对应规划条目）
|
||||
- 主记录路径/版本：不适用
|
||||
- 对应里程碑：不适用
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | 五个候选（含第二个 PI 档与 Codex）各 3 次、Codex 最后、全部失败暂停询问 | 符合：控制器已按声明顺序对 `unavailable`/`failed-clean` 自动续跑；模型 ID 经本机冒烟（agy `gemini-3.8-flash-high`、pi `zai-coding-cn/glm-5.3-flash`、codex `gpt-6.1-sol` 均回 OK，SELF） | P2 | validate 通过；文档一致；CI 通过 | 无 | 接受 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用：纯配置：Codex 从应急档改为各角色最后一个正常候选（校验器禁止应急档进入普通角色列表，且应急档只跑 1 次，故不保留 `emergency_profile`）；新增 `pi-glm` 档
|
||||
- 实施计划引用：I1 / R1：单一 Agent 单元改 `AGENT-EXECUTION.md` 与三份 policy 文本
|
||||
- 测试计划引用：R1：`make agent-exec-validate`；PR HEAD 完整 CI
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | d2035c7 | 已完成 | host | 2026-10-20 | 用户直接请求 |
|
||||
| 需求评估 | d2035c7 | 已完成 | host | 2026-10-20 | R1 接受 |
|
||||
| 需求表确认 | d2035c7 | 跳过 | — | 2026-10-20 | 用户请求已明确目标与验收，无取舍 |
|
||||
| 方案设计 | 890313e | 已完成 | host | 2026-10-20 | 本卡方案与计划段 |
|
||||
| 实施计划 | 890313e | 已完成 | host | 2026-10-20 | 本卡方案与计划段 |
|
||||
| 实施与自检 | 8e21b66 | 已完成 | cursor-agent-stable | 2026-10-20 | Agent 实施收据表 |
|
||||
| 正式测试与验收 | 8e21b66 | 已完成（SELF；GATE 待 CI） | host | 2026-10-20 | 证据表 |
|
||||
| 代码 Review | 8e21b66 | PASS | host 主模型 | 2026-10-20 | 合入与清理段 |
|
||||
| 合入 | 待定 | 待执行 | — | — | — |
|
||||
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| I1 | 纯配置即可实现五候选链、Codex 最后、每候选 3 次 | AGENT-EXECUTION.md + 3 份 policy | validate 与 CI 通过即停 | 用户直接请求 | 三个新模型 ID 冒烟回 OK（SELF）；validate PASS | 全部角色路由 | 否 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | d2035c76dc1cb15e01d2c184af5155d9d773cd9f | d2035c76dc1cb15e01d2c184af5155d9d773cd9f | 2026-10-20T05:56:50Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态：窗口已领取；调度记录：#518 comment 8226（mq-dev-20261020-cli-agent-fallback-chain-01）
|
||||
- entry_id：无；attempt_id：无；窗口执行者：无
|
||||
- 固定候选：无（base/head、组件与相关配置引用实际尝试）
|
||||
- 调度依据：policy/delivery.md#合入调度
|
||||
- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果：四个角色候选链为 cursor(auto) → antigravity(`gemini-3.8-flash-high`) → pi-glm(`zai-coding-cn/glm-5.3-flash`) → pi(`minimax-cn/MiniMax-M3`) → codex(`gpt-6.1-sol`)（test/review 前四项顺序不同，Codex 均最后），每候选最多 3 次；去掉 `emergency_profile`；policy 三份文本同步“自动换候选不询问、全部耗尽暂停询问是否重试”。
|
||||
- 验证：`make agent-exec-validate` PASS；`make test-governance` PASS（513 tests，skipped=18）；`make task-sync` PASS；三个新模型 ID 冒烟 PASS（SELF，未入证据表）；PR HEAD 完整 CI 待 GATE。
|
||||
- 影响与剩余项：仅影响 Agent 执行路由。运行时随机顺序未实现（非目标，声明顺序满足“顺序不限、Codex 最后”）；`failed-unknown` 等 fail-stop 仍立即停止、不换候选。
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余：R1 完成，无剩余
|
||||
- 首选下一任务：无（独立小改动）
|
||||
- 推荐依据：不适用
|
||||
- 前置条件/待确认：无
|
||||
- 预期产物/验收条件：不适用
|
||||
- 重复任务核对：远端分流 NEW（唯一候选 rdm-two-trees-followup 无关）
|
||||
- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：host 主模型（未撰写实施单元；平台账号 weichen）审阅 890313e..8e21b66 实际 diff（AGENT-EXECUTION.md 机器块与说明、delivery/governance/tool-adaptation-matrix 指定段落），重放 `make agent-exec-validate`；结论 PASS，无阻塞项（非阻塞：AGENT-EXECUTION.md 一行超过 78 列）。
|
||||
- 冲突记录：窗口内 `make task-sync` 合入 main f1866dc（changed=1），无冲突；main 侧对 AGENT-EXECUTION.md 仅在 cursor 档加注释，与本改动正交；合并后重跑 `make agent-exec-validate` PASS。
|
||||
- CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果）
|
||||
- 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验）
|
||||
- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T05:55:50.540864+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"after_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=d2035c76dc",
|
||||
"[remote] origin/main=d2035c76dc ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=7",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] d2035c76dc（完整：d2035c76dc1cb15e01d2c184af5155d9d773cd9f）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "ecc7f16b6bcabae29ac639e9d5d31ab0bc39f85e0fe0b51449d7b69412ba2d08",
|
||||
"receipt_sha256": "a8789614c5e3adf44db1e46a6fee98cfabea7b7e79708756d63c4aa756359b79",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/a8789614c5e3adf44db1e46a6fee98cfabea7b7e79708756d63c4aa756359b79.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T06:00:53.614147+00:00",
|
||||
"command": "make agent-exec-validate",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain",
|
||||
"before_head": "8e21b66db4606c20a1d7de4f1293fbcd61780658",
|
||||
"after_head": "8e21b66db4606c20a1d7de4f1293fbcd61780658",
|
||||
"branch": "feature/cli-agent-fallback-chain",
|
||||
"target_branch": "main",
|
||||
"target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'",
|
||||
"scripts/agent-exec validate --repo .",
|
||||
"validate: ok",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'"
|
||||
],
|
||||
"output_sha256": "74357235852380ff3b7cbcb532b030dc924e8d11a6b2e39dfcb729717e460660",
|
||||
"receipt_sha256": "1f3ed60af7d5c96fd19ba0b2f89142237b61597e30e7c9578ec20b8c6bfb60f5",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/1f3ed60af7d5c96fd19ba0b2f89142237b61597e30e7c9578ec20b8c6bfb60f5.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T06:01:05.726907+00:00",
|
||||
"command": "make task-sync",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain",
|
||||
"before_head": "95aba5d68d68f1e3f35887a93aec41b464638a95",
|
||||
"after_head": "95aba5d68d68f1e3f35887a93aec41b464638a95",
|
||||
"branch": "feature/cli-agent-fallback-chain",
|
||||
"target_branch": "main",
|
||||
"target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[worktree] before-update: recursive component checks passed",
|
||||
"[worktree] materialize: recursive component checks passed",
|
||||
"[worktree] after-sync: recursive component checks passed",
|
||||
"[evidence] WARN JSON receipt line 120: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[synced] sync_base=d2035c76dc1cb15e01d2c184af5155d9d773cd9f tested_head=95aba5d68d68f1e3f35887a93aec41b464638a95 checked_at=2026-10-20T06:01:57Z changed=0 sync_target=main",
|
||||
"[next] 跑正式验收（make test 等），证据写入任务卡",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'"
|
||||
],
|
||||
"output_sha256": "e797ab5e6a3e9bd075c44fdfe89f72e36a3e2f2fa892e6194501f7c88f46ceb1",
|
||||
"receipt_sha256": "d05e26eda35110298bb7721e35872f95cdc6c62964c0bf8a84e6db0f06e07775",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/d05e26eda35110298bb7721e35872f95cdc6c62964c0bf8a84e6db0f06e07775.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T06:04:41.162206+00:00",
|
||||
"command": "make task-sync",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain",
|
||||
"before_head": "c41e773d1e11a052ff53b32d493a3fa3e025ea99",
|
||||
"after_head": "c41e773d1e11a052ff53b32d493a3fa3e025ea99",
|
||||
"branch": "feature/cli-agent-fallback-chain",
|
||||
"target_branch": "main",
|
||||
"target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[worktree] before-update: recursive component checks passed",
|
||||
"[worktree] materialize: recursive component checks passed",
|
||||
"[worktree] after-sync: recursive component checks passed",
|
||||
"[evidence] WARN JSON receipt line 120: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[synced] sync_base=d2035c76dc1cb15e01d2c184af5155d9d773cd9f tested_head=c41e773d1e11a052ff53b32d493a3fa3e025ea99 checked_at=2026-10-20T06:05:34Z changed=0 sync_target=main",
|
||||
"[next] 跑正式验收（make test 等），证据写入任务卡",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'"
|
||||
],
|
||||
"output_sha256": "40878f3432df9e7aa449f4304ca79a36a9f2c9d3253e229481283dd119efc992",
|
||||
"receipt_sha256": "cf538efd2a1d13e0f740447675779b37e3ae0db15fa78cc6553856ac2dbb6cc1",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/cf538efd2a1d13e0f740447675779b37e3ae0db15fa78cc6553856ac2dbb6cc1.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T06:06:03.531305+00:00",
|
||||
"command": "make task-sync",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain",
|
||||
"before_head": "3a6ffb97ad0cab5c215f684f27108dbd92f23129",
|
||||
"after_head": "3a6ffb97ad0cab5c215f684f27108dbd92f23129",
|
||||
"branch": "feature/cli-agent-fallback-chain",
|
||||
"target_branch": "main",
|
||||
"target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[worktree] before-update: recursive component checks passed",
|
||||
"[worktree] materialize: recursive component checks passed",
|
||||
"[worktree] after-sync: recursive component checks passed",
|
||||
"[evidence] WARN JSON receipt line 120: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[synced] sync_base=d2035c76dc1cb15e01d2c184af5155d9d773cd9f tested_head=3a6ffb97ad0cab5c215f684f27108dbd92f23129 checked_at=2026-10-20T06:06:49Z changed=0 sync_target=main",
|
||||
"[next] 跑正式验收（make test 等），证据写入任务卡",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'"
|
||||
],
|
||||
"output_sha256": "1be7bf73418483205369a97f0b90f7ff7a2709effd5ca44875e59f6ff1b2d955",
|
||||
"receipt_sha256": "2756940470feebd40744bd42504690f19dfeebd9d76cca06369b57e36fe7caa3",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/2756940470feebd40744bd42504690f19dfeebd9d76cca06369b57e36fe7caa3.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T06:08:38.659173+00:00",
|
||||
"command": "make test-governance",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain",
|
||||
"before_head": "286c3ab0c16fff6ead69a62f470977de4cec656e",
|
||||
"after_head": "286c3ab0c16fff6ead69a62f470977de4cec656e",
|
||||
"branch": "feature/cli-agent-fallback-chain",
|
||||
"target_branch": "main",
|
||||
"target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"test_feature_missing_parent_is_allowed (test_write_guard.WriteGuardTests.test_feature_missing_parent_is_allowed) ... ok",
|
||||
"test_invalid_json_is_denied (test_write_guard.WriteGuardTests.test_invalid_json_is_denied) ... ok",
|
||||
"test_missing_parent_on_main_is_denied (test_write_guard.WriteGuardTests.test_missing_parent_on_main_is_denied) ... ok",
|
||||
"test_missing_unknown_and_malformed_write_input_are_denied (test_write_guard.WriteGuardTests.test_missing_unknown_and_malformed_write_input_are_denied) ... ok",
|
||||
"test_non_git_destination_is_explicitly_outside_scope (test_write_guard.WriteGuardTests.test_non_git_destination_is_explicitly_outside_scope) ... ok",
|
||||
"test_nonwrite_tools_are_outside_scope (test_write_guard.WriteGuardTests.test_nonwrite_tools_are_outside_scope) ... ok",
|
||||
"test_relative_path_uses_hook_cwd_not_process_cwd (test_write_guard.WriteGuardTests.test_relative_path_uses_hook_cwd_not_process_cwd) ... ok",
|
||||
"test_symlink_into_main_with_missing_parents_is_denied (test_write_guard.WriteGuardTests.test_symlink_into_main_with_missing_parents_is_denied) ... ok",
|
||||
"test_valid_multi_file_patch_on_feature_is_allowed (test_write_guard.WriteGuardTests.test_valid_multi_file_patch_on_feature_is_allowed) ... ok",
|
||||
"",
|
||||
"----------------------------------------------------------------------",
|
||||
"Ran 513 tests in 365.638s",
|
||||
"",
|
||||
"OK (skipped=18)",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'"
|
||||
],
|
||||
"output_sha256": "750f575e91446dc8480ec53ac70d500852145ae12a75d19ef96390baaf6d55a2",
|
||||
"receipt_sha256": "14ba55cc1c8585e2a24ef81e0f4edaf74277b83fb47d76fa7bd95dda815cceec",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/14ba55cc1c8585e2a24ef81e0f4edaf74277b83fb47d76fa7bd95dda815cceec.json"
|
||||
}
|
||||
```
|
||||
| 同步（记录前对象） | f1866dc3bb4537ac6446fdd26e696cb636b543ef | 16913620d8cbf214bf81792c5ff03eaee94752cd | 2026-10-20T07:48:20Z |
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T07:47:26.429534+00:00",
|
||||
"command": "make task-sync",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain",
|
||||
"before_head": "6bf1000547cc533b914dcb79ad37573b7d33cf61",
|
||||
"after_head": "f60effc6326ae8847cb1a39bef469c83d812c385",
|
||||
"branch": "feature/cli-agent-fallback-chain",
|
||||
"target_branch": "main",
|
||||
"target_head": "f1866dc3bb4537ac6446fdd26e696cb636b543ef",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
" create mode 100644 docker/verify-env.sh",
|
||||
" create mode 100644 docs/superpowers/specs/2026-10-20-fast-slow-o2-i1-review.md",
|
||||
"[worktree] before-update: recursive component checks passed",
|
||||
"[worktree] materialize: recursive component checks passed",
|
||||
"[worktree] after-sync: recursive component checks passed",
|
||||
"admit: ok",
|
||||
"[evidence] WARN JSON receipt line 120: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 159: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 189: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 224: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 259: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 294: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[synced] sync_base=f1866dc3bb4537ac6446fdd26e696cb636b543ef tested_head=f60effc6326ae8847cb1a39bef469c83d812c385 checked_at=2026-10-20T07:48:20Z changed=1 sync_target=main",
|
||||
"[next] 跑正式验收（make test 等），证据写入任务卡",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'"
|
||||
],
|
||||
"output_sha256": "9671a18a5835bfbad2bade03cd21602d59eb40b92f070c258b186ecea7ae9a58",
|
||||
"receipt_sha256": "c4547470f11d63491ea2f2c4b23c6a46425e5362f37dd23d13f1770165e32057",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/c4547470f11d63491ea2f2c4b23c6a46425e5362f37dd23d13f1770165e32057.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T07:48:38.505764+00:00",
|
||||
"command": "make agent-exec-validate",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain",
|
||||
"before_head": "b90d3aaee9550271cb7c2acd200267f3605d6fca",
|
||||
"after_head": "b90d3aaee9550271cb7c2acd200267f3605d6fca",
|
||||
"branch": "feature/cli-agent-fallback-chain",
|
||||
"target_branch": "main",
|
||||
"target_head": "f1866dc3bb4537ac6446fdd26e696cb636b543ef",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'",
|
||||
"scripts/agent-exec validate --repo .",
|
||||
"validate: ok",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cli-agent-fallback-chain'"
|
||||
],
|
||||
"output_sha256": "74357235852380ff3b7cbcb532b030dc924e8d11a6b2e39dfcb729717e460660",
|
||||
"receipt_sha256": "8a2946c846a8e64c76222cefd05e91161131d1fae4d8b8412dd4e8d90c562fd7",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/8a2946c846a8e64c76222cefd05e91161131d1fae4d8b8412dd4e8d90c562fd7.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（合入前折叠）
|
||||
|
||||
- 本卡在 PR #648（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/648）合入前闭合并归档，随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填，也无需单独的闭合 PR。
|
||||
@@ -0,0 +1,413 @@
|
||||
# feature/conversation-handoff 任务卡
|
||||
|
||||
任务主记录：PR #651 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/651；状态：已完成（合入前闭合）；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= f97917032d143188bc7faf665aff612d9814af4e
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff（worktree）；分支：feature/conversation-handoff
|
||||
- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
|
||||
- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=19ad0cf4b00048ede29774b079a28c2d8e417b9363c9cbe266ce99852b2594f9；triage_receipt=/tmp/task-handoff-triage-20261020.json；receipt_sha256=2ace0e14daaab36c1418ac3ce392cdbbf6e43722ddc86663b4939c8d85f9a930
|
||||
|
||||
- 授权与交付终点：更新本仓任务交付规范，规定每轮结束时最终回复附可续作 handoff；按现行门禁完成 Review、PR、CI、合入与安全收口。不得修改共享规范子模块或增加自动化。
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段：最终验证与合入；当前增量：I1（对话收尾交接块规范）
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
在 `policy/delivery.md` 定义最终回复 handoff 的最小字段、证据边界和无续办状态时的处理，并在 `AGENTS.md` 增加强制入口。共享 Development-Guidelines、模板、schema、自动化和测试不是本次范围。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| conversation-handoff-rules | `AGENTS.md`, `policy/delivery.md` | 701aa8b8 | implementation | cursor, antigravity, pi | 1 | Cursor / auto | success | success (`a98f095`) | false | `/tmp/task-handoff-implementation-20261020.json` |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态：待核对（无适用规划时说明原因）
|
||||
- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文）
|
||||
- 对应里程碑：待核对
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | 每轮用户任务结束时提供可在上下文清理后恢复工作的 handoff | 与现有任务卡为状态权威、阶段 handoff 落盘规则一致；对话 handoff 仅作恢复摘要 | 必须 | 最终回复末尾有自包含续作要点，未发生的信息不编造；无仓库与续办状态时允许一行明确不适用 | 无 | 已实现；待 CI 准入 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用：待填写（含对象版本）
|
||||
- 实施计划引用：待填写（含增量与需求 ID）
|
||||
- 测试计划引用：待填写（含需求 ID 与验收条件）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解/评估 | f97917032d143188bc7faf665aff612d9814af4e | 完成 | 主模型；NEW，与现有 RDM initiative 不相关 | 2026-10-20 | triage receipt `/tmp/task-handoff-triage-20261020.json` |
|
||||
| 方案/实施计划 | a98f095cef5ede016440d92060fa62db03b7318b | 完成 | 主模型；仅更新规范权威与入口摘要 | 2026-10-20 | 本卡目标与范围 |
|
||||
| 实施与自检 | a98f095cef5ede016440d92060fa62db03b7318b | 完成 | Cursor CLI；transport 成功，host 检查 | 2026-10-20 | `/tmp/task-handoff-implementation-20261020.json`；`git show --check --format= HEAD`；`make agent-exec-validate` |
|
||||
| 正式测试与验收 | 0dcaa430e0d724752aef1f55f120f419eeda9ad4 | 阻塞 | 文档直接检查通过；代码测试不适用 | 2026-10-20 | GATE CI run #4403 的 `test-pg` 失败，日志为 `TestArtifactFacadeCard` 的 anchorMessageId 不匹配；`svc-realcombo` 通过，`test` 当时 pending |
|
||||
| 代码 Review | 0dcaa430e0d724752aef1f55f120f419eeda9ad4 | 通过 | 主模型审阅规范差异及链接 | 2026-10-20 | 仅涉及 `AGENTS.md`、`policy/delivery.md`；无规范缺陷 |
|
||||
| 合入 | 待定 | 待执行 | agent | — | — |
|
||||
| 合入核验与收口 | 待定 | 待执行 | host | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | f97917032d143188bc7faf665aff612d9814af4e | f97917032d143188bc7faf665aff612d9814af4e | 2026-10-20T07:09:18Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态：持有最终窗口；调度记录：#518 comment 8266
|
||||
- entry_id：mq-dev-20261020-conversation-handoff-01；attempt_id：final-01；窗口执行者：host / weichen
|
||||
- 固定候选：无（base/head、组件与相关配置引用实际尝试）
|
||||
- 调度依据：policy/delivery.md#合入调度
|
||||
- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果：增加最终回复 handoff 规范及 AGENTS 强制指针；与任务卡/持久阶段交接权威边界一致。
|
||||
- 验证：旧候选的 GATE 失败保留为历史；当前已同步权威 main 17f8bc06c110014b9101e7a33729d9f5445bd123，文档范围/字段/链接/现行规则保留、agent-exec validate 和递归组合检查均 SELF PASS（下方原始 evidence）。最终 HEAD 的 test/test-pg/svc-realcombo GATE 待运行。
|
||||
- 影响与剩余项：规范变更已就绪；Backend 修复 #226 已合入但 Dev 组合采用由独立 #653 承担。本 PR 仅规范与任务记录，须最终 HEAD 三项 CI 全绿后合入。
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余：完成已授权的对话 handoff 规范；不属长期业务方案，剩余为当前候选 GATE、合入核验和安全收口。
|
||||
- 首选下一任务：完成本 PR 当前交付，无新增任务；新版运行时组合已有 PR #653，继续由原任务负责。
|
||||
- 推荐依据：待填写
|
||||
- 前置条件/待确认：待核对
|
||||
- 预期产物/验收条件：待定义
|
||||
- 重复任务核对：待核对（已有/在途任务、PR 与规划记录）
|
||||
- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：PASS（主模型；head `0dcaa430e0d724752aef1f55f120f419eeda9ad4`；规范范围与链接审阅通过）
|
||||
- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测）
|
||||
- CI 记录：FAIL（GATE；head `0dcaa430e0d724752aef1f55f120f419eeda9ad4`；run #4403；`test-pg` 的 `TestArtifactFacadeCard` 失败，`svc-realcombo` 通过，`test` 为 pending；[job 7138](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/actions/runs/4403/jobs/7138)）
|
||||
- 合入记录：NOT_RUN（CI 未通过，未合入）
|
||||
- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T07:08:07.377183+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "f97917032d143188bc7faf665aff612d9814af4e",
|
||||
"after_head": "f97917032d143188bc7faf665aff612d9814af4e",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "f97917032d143188bc7faf665aff612d9814af4e",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=f97917032d",
|
||||
"[remote] origin/main=f97917032d ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=8",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] f97917032d（完整：f97917032d143188bc7faf665aff612d9814af4e）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "601e28fd5627afdf978a470ef2b37265fee4ff28520a4668dd8e6a19ce5553e6",
|
||||
"receipt_sha256": "237e2888ced51370c2ca6ba41989e490f6e00c72bdbb74d008a15725efcaff65",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/237e2888ced51370c2ca6ba41989e490f6e00c72bdbb74d008a15725efcaff65.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（合入前折叠）
|
||||
|
||||
- 本卡在 PR #651（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/651）合入前闭合并归档，随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填，也无需单独的闭合 PR。
|
||||
|
||||
## 2026-10-20 恢复与 fail-stop 对账
|
||||
|
||||
- 用户再次明确“继续”，目标仍为 PR #651 通过必要验证并合入；已授权修复阻塞合入的 Backend 测试，禁止 host 代写。
|
||||
- 原 repair run `290c8b13f4a4a9e5d67df066754ab3fd` 的终态仍为 `scope-expansion`，没有 transport，不导入任何产物；原隔离现场保留。
|
||||
- 已只读检查唯一未跟踪诊断文件 `internal/server/zz_diag_tmp_test.go` 与实际工具事件；未发现仓库正式代码、引用或远端修改。机器本地诊断产物位于 `/tmp/ciflake-943183` 与 `~/.cache/ciflake-943183-tmp`，原执行器记录的进程及该现场写者已退出。
|
||||
- 原包把 `internal/server/**` 当作目录通配，但执行器仅按精确路径或目录前缀匹配；新单元须使用明确文件清单，不续跑原尝试、不修改执行器。
|
||||
- Backend 已登记任务工作区已保留并移至 `/home/weichen/projects/Agent-System-Backend-wt-fix-ci-pg-flaky-tests`，修复 Git 与唯一已初始化子模块的路径元数据；Dev 工作树的未跟踪嵌套工作区阻塞已消除。
|
||||
- 启动检查原始 SELF 收据：`/tmp/pr651-resume-20261020-a1.json`（SHARED_WORKSPACE_BUSY）、`/tmp/pr651-resume-20261020-a2.json`（任务卡已归档，拒绝 LOCAL_READY）；不宣称通过。恢复活动卡后重新检查。
|
||||
- GATE 重新只读核验：PR #651 head `19566bfde79313dfaea31ff6f5ca918f820c1606` 仍开放；run 4404 的 test/svc-realcombo success，test-pg failure；日志 `/tmp/pr651-job7141.log`。目标 main 当前 `f1866dc3bb4537ac6446fdd26e696cb636b543ef`；#648 持有交付窗口，本任务先局部排障。
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T08:46:38.272183+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "f9884db84b7fb5752d50b641f09adb75303e327c",
|
||||
"after_head": "f9884db84b7fb5752d50b641f09adb75303e327c",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "adbef2f49c6c252a09449496afbdb6685201993b",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'",
|
||||
"[repo] branch=feature/conversation-handoff head=f9884db84b",
|
||||
"[remote] origin/main=adbef2f49c ahead=6 behind=26",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=6",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[target] adbef2f49c6c252a09449496afbdb6685201993b（observed; task initial baseline is reported separately）",
|
||||
"[task-state] registered=/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff initial_base=f97917032d143188bc7faf665aff612d9814af4e",
|
||||
"[verdict] LOCAL_READY — existing task may continue authorized local work; final delivery still requires latest-target sync and checks",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'"
|
||||
],
|
||||
"output_sha256": "be0eda106b0ed68d8f108a607b83c5231d1c34c744675a83995638fa5e39aa43",
|
||||
"receipt_sha256": "12bb48774c59da7635b3b0cf1ef81465b5fe29475baaf880c72a1a82a0649f46",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/12bb48774c59da7635b3b0cf1ef81465b5fe29475baaf880c72a1a82a0649f46.json"
|
||||
}
|
||||
```
|
||||
|
||||
- 局部恢复已通过并导入：`/tmp/pr651-resume-20261020-a6.json`（LOCAL_READY，SELF）；正式交付需新鲜同步与固定 HEAD CI。
|
||||
- 新 repair 单元：`ci-pg-async-completion-r2`；固定 Backend base `e927694818f3c0b79ec663d70ab2aa9d47d8fd8f`；工作包 `/tmp/pr651-repair-unit-r2.json`；收据目标 `/tmp/pr651-repair-r2.json`；运行中，尚无成功产物。
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T09:09:46.106201+00:00",
|
||||
"command": "cd /home/weichen/projects/Agent-System-Backend-wt-fix-ci-pg-flaky-tests && git rev-parse HEAD && GOWORK=off go vet ./... && GOWORK=off go test -count=1 ./...",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "4544cd94f8ece209b32aec885a410e5eeaef968e",
|
||||
"after_head": "4544cd94f8ece209b32aec885a410e5eeaef968e",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "17f8bc06c110014b9101e7a33729d9f5445bd123",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"ok \tagent-system-backend/internal/runtime\t1.834s",
|
||||
"ok \tagent-system-backend/internal/server\t28.474s",
|
||||
"ok \tagent-system-backend/internal/settings\t0.211s",
|
||||
"ok \tagent-system-backend/internal/skills\t1.741s",
|
||||
"ok \tagent-system-backend/internal/squadadapter\t0.158s",
|
||||
"ok \tagent-system-backend/internal/store\t12.820s",
|
||||
"ok \tagent-system-backend/internal/surfacesvc\t0.399s",
|
||||
"ok \tagent-system-backend/internal/tools\t13.619s",
|
||||
"ok \tagent-system-backend/internal/vision\t0.003s",
|
||||
"ok \tagent-system-backend/internal/wfcompile\t0.050s",
|
||||
"ok \tagent-system-backend/internal/workflow\t0.002s",
|
||||
"ok \tagent-system-backend/pkg/extension\t0.004s",
|
||||
"ok \tagent-system-backend/pkg/extension/link\t0.006s",
|
||||
"ok \tagent-system-backend/pkg/identity\t0.095s",
|
||||
"? \tagent-system-backend/web\t[no test files]"
|
||||
],
|
||||
"output_sha256": "08769f0589e95d0b7878ce3551b931aceae5f80ad4916cc5f64bfd53ae5cfbb0",
|
||||
"receipt_sha256": "d0a0fa46d65618338b88d99c72e53402449454c740fe7399d6354b7a80f5d084",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/d0a0fa46d65618338b88d99c72e53402449454c740fe7399d6354b7a80f5d084.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T09:13:47.514647+00:00",
|
||||
"command": "cd /home/weichen/projects/Agent-System-Backend-wt-fix-ci-pg-flaky-tests && git rev-parse HEAD && git diff --check origin/main HEAD && GOWORK=off go test ./internal/server ./internal/runmgr -run \"^(TestArtifactFacadeCard|TestMockCardflowFullLoop|TestMockCardflowStreamLoop|TestBackground.*|TestProjectEvents.*|TestUnregisteredProjectEventsRetainLegacyReads)$\" -count=1",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "4544cd94f8ece209b32aec885a410e5eeaef968e",
|
||||
"after_head": "4544cd94f8ece209b32aec885a410e5eeaef968e",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "17f8bc06c110014b9101e7a33729d9f5445bd123",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"910d8e5fd20747eebc6e53b5fc0118185cb53765",
|
||||
"ok \tagent-system-backend/internal/server\t6.436s",
|
||||
"ok \tagent-system-backend/internal/runmgr\t0.495s"
|
||||
],
|
||||
"output_sha256": "3015a2c860e2066174d3f89da874b63b403192d9aa870b0a3fa4e238f1db9e24",
|
||||
"receipt_sha256": "5d2035b4cc2d543ec86a9fa19b93ed143ff6a637ab275a328827ad5ba02e7b56",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/5d2035b4cc2d543ec86a9fa19b93ed143ff6a637ab275a328827ad5ba02e7b56.json"
|
||||
}
|
||||
```
|
||||
|
||||
## Backend 修复结果与本 PR 最终范围
|
||||
|
||||
- repair r2 已通过 completed/transport：2ee469011e66b6bedcf6e9d87c8b1c026f7a8cef，仅三个测试文件；主模型审阅与独立重放通过。
|
||||
- Backend PR #226 已合入 508288fbed318ec808b1da1145417d062f9e0ce2；精确候选 910d8e5fd20747eebc6e53b5fc0118185cb53765 的 ci/vet-and-test、governance 全部 GATE success；来源 /tmp/pr651-backend-gate.json 与 /tmp/pr651-backend-merged.json。
|
||||
- 新版 Backend 同时包含尚待 Dev 组合采用的 O2 依赖，已有独立 PR #653；本规范 PR 不推进 gitlink，以免提前采用另一任务的运行时组合。#651 在最新 main 上重新验证，Backend 修复的已合入与 Dev 已采用分别记录。
|
||||
- 交付窗口 mq-dev-20261020-conversation-handoff-01 已在 #518 领取；此前 #652 已释放。当前需 task-sync、闭合任务卡、固定候选并等待三项 GATE。
|
||||
| 同步（记录前对象） | 17f8bc06c110014b9101e7a33729d9f5445bd123 | d0150787e2ba7fec94575e42c9bea2f945418c71 | 2026-10-20T09:20:53Z |
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T09:20:09.212113+00:00",
|
||||
"command": "make task-sync",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "0dd24cafc6024d5854957ff8f5b6ecb2c65d3c72",
|
||||
"after_head": "11245d172c6841a17696a041889b8dbc4d8807a7",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "17f8bc06c110014b9101e7a33729d9f5445bd123",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
" create mode 100644 .task/archive/feature-fast-slow-o2-i1-agent-native.md",
|
||||
" create mode 100644 .task/archive/feature-fast-slow-o2-i2-backend.md",
|
||||
" create mode 100644 docs/superpowers/specs/2026-10-20-fast-slow-o2-i1-review.md",
|
||||
" create mode 100644 docs/superpowers/specs/2026-10-20-fast-slow-o2-i2-review.md",
|
||||
"[worktree] before-update: recursive component checks passed",
|
||||
"[worktree] materialize: recursive component checks passed",
|
||||
"[worktree] after-sync: recursive component checks passed",
|
||||
"admit: ok",
|
||||
"[evidence] WARN JSON receipt line 113: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 168: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 210: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 251: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[synced] sync_base=17f8bc06c110014b9101e7a33729d9f5445bd123 tested_head=11245d172c6841a17696a041889b8dbc4d8807a7 checked_at=2026-10-20T09:20:53Z changed=1 sync_target=main",
|
||||
"[next] 跑正式验收（make test 等），证据写入任务卡",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'"
|
||||
],
|
||||
"output_sha256": "447fa8d3b023bd473ca8076ad32b77ac406c86f6ff097e032b1c602e7a4649c6",
|
||||
"receipt_sha256": "faa7ddd69578d19c3c5280c5633868612431065be8ad6d74c37f15eca7642427",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/faa7ddd69578d19c3c5280c5633868612431065be8ad6d74c37f15eca7642427.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T09:21:27.020003+00:00",
|
||||
"command": "python3 /tmp/pr651-doc-check.py && make agent-exec-validate && make test-worktree",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "11245d172c6841a17696a041889b8dbc4d8807a7",
|
||||
"after_head": "11245d172c6841a17696a041889b8dbc4d8807a7",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "17f8bc06c110014b9101e7a33729d9f5445bd123",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "56ecb85dcdac1667ad1f575d1021a6f5306fabf593cfa8326465e9997f56c62e",
|
||||
"after_tracked_diff_sha256": "56ecb85dcdac1667ad1f575d1021a6f5306fabf593cfa8326465e9997f56c62e",
|
||||
"output_tail": [
|
||||
"tested Dev HEAD 11245d172c6841a17696a041889b8dbc4d8807a7",
|
||||
"PASS handoff fields, authoritative links, document scope and preservation of current main policies",
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'",
|
||||
"scripts/agent-exec validate --repo .",
|
||||
"validate: ok",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'",
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'",
|
||||
"python3 scripts/check-worktree.py verify",
|
||||
"[worktree] verify: recursive component checks passed",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'"
|
||||
],
|
||||
"output_sha256": "e7627921f53b21804805a831022ddae38dae1b31a328efabd2ad4db6a9329638",
|
||||
"receipt_sha256": "3f45ddbd4927efd7848281e5575c71ad8b5b411584650f5440cd9327e0c08ace",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/3f45ddbd4927efd7848281e5575c71ad8b5b411584650f5440cd9327e0c08ace.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 最终对象审阅
|
||||
|
||||
- host Review 对同步后 11245d172c6841a17696a041889b8dbc4d8807a7 完成：相对 origin/main 的业务差异只有 AGENTS.md 一行与 policy/delivery.md 新增 22 行，另有本任务记录；现行 AGENT-EXECUTION.md 与其它 policy 无回退。
|
||||
- 需求 R1 的七项 handoff 字段、无续办例外、证据权威边界和入口链接均直接复核通过。文档没有新增平台功能，不制造业务测试。真实模型行为前后量化 NOT_RUN；当前规范交付以可审条款、链接和 GATE 为依据，不声称完成行为评测。
|
||||
- main 同步原始输出、文档检查与递归组合输出均由 make evidence 原样写入本卡。最终候选固定后只保存在源码外记录，避免为回填 CI 再改变 HEAD。
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T09:23:34.774230+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff",
|
||||
"before_head": "2aad4bc2acf0cf7fb29ce5df604bcaff83c054bd",
|
||||
"after_head": "2aad4bc2acf0cf7fb29ce5df604bcaff83c054bd",
|
||||
"branch": "feature/conversation-handoff",
|
||||
"target_branch": "main",
|
||||
"target_head": "17f8bc06c110014b9101e7a33729d9f5445bd123",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'",
|
||||
"[repo] branch=feature/conversation-handoff head=2aad4bc2ac",
|
||||
"[remote] origin/main=17f8bc06c1 ahead=11 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=6",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] 17f8bc06c1（完整：17f8bc06c110014b9101e7a33729d9f5445bd123）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-conversation-handoff'"
|
||||
],
|
||||
"output_sha256": "df04e4a972fd4f2eec24c391d8892c85698ca0f00fe9950df3d4b91c27df48a2",
|
||||
"receipt_sha256": "f676ac17f42a3634b98cc3287cb7f891df70b5361970c14c4bd3dcd77a6290fa",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/f676ac17f42a3634b98cc3287cb7f891df70b5361970c14c4bd3dcd77a6290fa.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（合入前折叠）
|
||||
|
||||
- 本卡在 PR #651（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/651）合入前闭合并归档，随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填，也无需单独的闭合 PR。
|
||||
@@ -0,0 +1,392 @@
|
||||
# feature/cursor-explicit-model-auto 任务卡
|
||||
|
||||
任务主记录：PR #644 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/644；状态：已完成（合入前闭合）；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= ac594c90e536cfb670e94680f045a6c8247a2513
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto（worktree）；分支：feature/cursor-explicit-model-auto
|
||||
- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
|
||||
- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=26514fc286b951bcd1dc272da658bb3a80a15f4ad1a0f0f6a575b43ccd8c5bfd；triage_receipt=/tmp/cursor-model-auto-triage.json；receipt_sha256=ae6f04fa5645ecbb8a67878709f9c97f8caa77e9f41ef4b6f5f76549bcf67a6b
|
||||
|
||||
- 授权与交付终点：用户 2026-10-20 要求 cursor-agent 启动时加入 `--model auto`，并选定“只改 DM cursor 适配器 + Dev 升版本与说明”方案；授权范围内实施、验证、Review、PR 合入 Dev main 与安全收口。不部署、不发布版本、不改分支保护。
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段：实施与自检；当前增量：I1（DM repin + AGENT-EXECUTION.md 说明）
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
目标：Dev 的 `scripts/agent-exec` 派发 cursor 候选时，argv 显式包含 `--model auto`。DM 侧已由 [Development-Manager PR #30](https://git-home.u1680832.nyat.app:30319/weichen/Development-Manager/pulls/30) 合入（merge `1e5ee55a2881dc9ed210ced48338c4d75697aa9c`：内置 cursor 适配器 auto 时传 `--model auto`，其他适配器不变）。本仓：`deps/development-manager` 从 `6c019595` 升到 `1e5ee55a`；`AGENT-EXECUTION.md` 说明改为 cursor 在 `model: auto` 时显式传 `--model auto`，其他 CLI 仍省略。
|
||||
|
||||
验收：`scripts/agent-exec validate` 通过；DM adapters 测试在新 pin 通过；PR HEAD 完整 CI 通过。
|
||||
|
||||
非目标：不改 profile/路由/尝试上限，不改 `deps/development-guidelines` 或其内嵌 DM pin，不改其他 CLI 的 auto 语义。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| dev-cursor-explicit-auto-model-adopt | `deps/development-manager` gitlink + `AGENT-EXECUTION.md` 说明 | config_digest=ccf5b7c03ce4…（run 时 AGENT-EXECUTION.md blob e3c0b7f） | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde / auto（事件报告 `Auto`） | completed (success) | refs/agent-exec/1b5656f9…/ccc04e511e8a → 88f446531beb8702a4a95a41ce581e2d4323604d | 否 | /tmp/dev-cursor-model-auto-receipt.json（单元包 /tmp/dev-cursor-model-auto-unit.json） |
|
||||
| DM: agent-exec-cursor-explicit-auto-model | DM `internal/agentexec/adapters/{adapters,adapters_test}.go` | DM AGENT-EXECUTION.md config_digest=adeded0e9363… | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde / auto（事件报告 `Auto`） | completed (success) | DM refs/agent-exec/36405201…/9e8e5a55c9a5 → DM 9a565d65428c8acc02cf222fee1a7998a11de960 | 否 | /tmp/dm-cursor-model-auto-receipt.json |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态：不适用（用户直接提出的执行器参数调整，无对应规划条目）
|
||||
- 主记录路径/版本：不适用
|
||||
- 对应里程碑：不适用
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | cursor-agent 启动显式带 `--model auto` | 符合：消除本机默认模型漂移；`cursor-agent-stable --list-models` 列出 `auto` | P2 | Dev pin 含 DM #30；AGENT-EXECUTION.md 说明一致；CI 通过 | DM #30（已合入） | 接受 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用：DM 适配器新增 `builtinSpec.autoModel`，仅 cursor 设 `"auto"`（DM #30）；Dev repin + 说明
|
||||
- 实施计划引用：I1 / R1：DM 单元 → DM PR #30 → Dev 单元（repin + 说明）
|
||||
- 测试计划引用：R1：DM adapters 表驱动测试（cursor auto 传 `--model auto`，其他适配器不传）；`make agent-exec-validate`；PR HEAD 完整 CI
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | bef2032 | 已完成 | host | 2026-10-20 | 用户选定“只改 cursor 适配器”方案 |
|
||||
| 需求评估 | bef2032 | 已完成 | host | 2026-10-20 | R1 接受 |
|
||||
| 需求表确认 | bef2032 | 已完成 | 用户（AskQuestion 选择） | 2026-10-20 | 本卡授权段 |
|
||||
| 方案设计 | DM 9a565d6 | 已完成 | host | 2026-10-20 | DM #30 |
|
||||
| 实施计划 | bef2032 | 已完成 | host | 2026-10-20 | 本卡方案与计划段 |
|
||||
| 实施与自检 | 88f4465 | 已完成 | cursor-agent-stable（DM 与 Dev 各一单元） | 2026-10-20 | Agent 实施收据表 |
|
||||
| 正式测试与验收 | 2430123 | 已完成（SELF；GATE 待 CI） | host | 2026-10-20 | 证据表 |
|
||||
| 代码 Review | 88f4465 | PASS | host 主模型 | 2026-10-20 | 合入与清理段 |
|
||||
| 合入 | 待定 | 待执行 | — | — | — |
|
||||
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| I1 | cursor 显式 `--model auto` 可被 CLI 接受 | DM adapters + Dev pin/说明 | 测试与 CI 通过即停 | 用户选定方案 | `cursor-agent-stable -p --trust --model auto` 冒烟 success（SELF） | 仅 cursor argv | 否 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | ac594c90e536cfb670e94680f045a6c8247a2513 | ac594c90e536cfb670e94680f045a6c8247a2513 | 2026-10-20T03:41:37Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态：窗口已领取；调度记录：#518 comment 8141（mq-dev-20261020-cursor-explicit-model-auto-01）
|
||||
- entry_id：无；attempt_id：无；窗口执行者：无
|
||||
- 固定候选：无（base/head、组件与相关配置引用实际尝试）
|
||||
- 调度依据：policy/delivery.md#合入调度
|
||||
- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果：Dev 钉住 DM `1e5ee55a`（含 DM #30），`scripts/agent-exec` 派发 cursor 时 argv 显式带 `--model auto`；`AGENT-EXECUTION.md` 说明同步。其他 CLI 与机器配置块不变。
|
||||
- 验证：`make agent-exec-validate` PASS；新 pin 下 DM adapters 测试 PASS（证据表）；DM #30 CI success（GATE，DM b9627b8）；Dev 完整 CI 以 PR HEAD 为准。
|
||||
- 影响与剩余项：仅影响 cursor 候选启动参数。DM 卡 `.task/feature-cursor-explicit-model-auto.md` 状态已为“已完成（合入前闭合）”，因 DM pr-check 只认 `.task/` 顶层而未归档，留待 DM 下次闭合时归档。
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余：R1 完成，无剩余
|
||||
- 首选下一任务：无（独立小改动，无后续规划）
|
||||
- 推荐依据：不适用
|
||||
- 前置条件/待确认：无
|
||||
- 预期产物/验收条件：不适用
|
||||
- 重复任务核对：远端分流 NEW（唯一候选 rdm-two-trees-followup 无关）
|
||||
- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：host 主模型（未撰写实施单元；平台账号 weichen）审阅 DM #30 diff（7c234e5..9a565d6，adapters 两文件）与 Dev diff（bef2032..88f4465：gitlink 6c01959→1e5ee55、AGENT-EXECUTION.md 两处说明、机器块未变），重放 `make agent-exec-validate` 与 adapters 测试；结论 PASS，无阻塞项。
|
||||
- 冲突记录：窗口内 `make task-sync` changed=0（sync_base ac594c90），无冲突；组件递归检查通过；折叠闭合遗留 IAM 卡（precheck [cards] 清零）仅 `.task/`。
|
||||
- CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果）
|
||||
- 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验）
|
||||
- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T03:40:46.352366+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"after_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=ac594c90e5",
|
||||
"[remote] origin/main=ac594c90e5 ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=8",
|
||||
"[cards] 已合入未闭合任务卡:feature-iam-role-permission-linked-capabilities.md——make task-close 回填归档（主检出运行）",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] ac594c90e5（完整：ac594c90e536cfb670e94680f045a6c8247a2513）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "a8bd643e45829cc5e5757ed82e28c385f3d5f337ad481170f0e5aaf06c4799b8",
|
||||
"receipt_sha256": "b27f90c202c8879151dbb323b7881696ef598898553f2e2f73b53759d7461426",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/b27f90c202c8879151dbb323b7881696ef598898553f2e2f73b53759d7461426.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T03:55:29.488261+00:00",
|
||||
"command": "make agent-exec-validate",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto",
|
||||
"before_head": "88f446531beb8702a4a95a41ce581e2d4323604d",
|
||||
"after_head": "88f446531beb8702a4a95a41ce581e2d4323604d",
|
||||
"branch": "feature/cursor-explicit-model-auto",
|
||||
"target_branch": "main",
|
||||
"target_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto'",
|
||||
"scripts/agent-exec validate --repo .",
|
||||
"validate: ok",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto'"
|
||||
],
|
||||
"output_sha256": "8990e6bcf74eb84039840fc508f9c301cd4e82f0aae947c9426b5bd994df8ebb",
|
||||
"receipt_sha256": "2139d938d2fa14e6088e87cc0d8c65ee5b17eb0306fd9a0bca652fcb8e74b778",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/2139d938d2fa14e6088e87cc0d8c65ee5b17eb0306fd9a0bca652fcb8e74b778.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T03:55:35.879836+00:00",
|
||||
"command": "go -C deps/development-manager test -count=1 ./internal/agentexec/adapters/...",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto",
|
||||
"before_head": "88f446531beb8702a4a95a41ce581e2d4323604d",
|
||||
"after_head": "88f446531beb8702a4a95a41ce581e2d4323604d",
|
||||
"branch": "feature/cursor-explicit-model-auto",
|
||||
"target_branch": "main",
|
||||
"target_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "c88c90fec9ec2e2a666329cbf8876b9e36446bf9b37620e580e4d30fb4d39869",
|
||||
"after_tracked_diff_sha256": "c88c90fec9ec2e2a666329cbf8876b9e36446bf9b37620e580e4d30fb4d39869",
|
||||
"output_tail": [
|
||||
"ok \tdevelopment-manager/internal/agentexec/adapters\t0.006s"
|
||||
],
|
||||
"output_sha256": "a2539b823379f477727535b6ea6a4a1663a83e341b5c569d19ba3950de6065a8",
|
||||
"receipt_sha256": "8ccaa9132ffbbe8c3be1dbf2443c752e1602f3e8fe28587e869ba85ea5b4303b",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/8ccaa9132ffbbe8c3be1dbf2443c752e1602f3e8fe28587e869ba85ea5b4303b.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T03:56:53.133447+00:00",
|
||||
"command": "make agent-exec-validate",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto",
|
||||
"before_head": "88f446531beb8702a4a95a41ce581e2d4323604d",
|
||||
"after_head": "88f446531beb8702a4a95a41ce581e2d4323604d",
|
||||
"branch": "feature/cursor-explicit-model-auto",
|
||||
"target_branch": "main",
|
||||
"target_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "6221fca98cdc185f5a255a12a7982f29ae8332735aa8d258853872382e2fcc1a",
|
||||
"after_tracked_diff_sha256": "6221fca98cdc185f5a255a12a7982f29ae8332735aa8d258853872382e2fcc1a",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto'",
|
||||
"scripts/agent-exec validate --repo .",
|
||||
"validate: ok",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto'"
|
||||
],
|
||||
"output_sha256": "8990e6bcf74eb84039840fc508f9c301cd4e82f0aae947c9426b5bd994df8ebb",
|
||||
"receipt_sha256": "c036b3d15acaf33ae32da7ae882429cc42e1507f68acdb6b8476f180000fb897",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/c036b3d15acaf33ae32da7ae882429cc42e1507f68acdb6b8476f180000fb897.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T03:56:55.499605+00:00",
|
||||
"command": "go -C deps/development-manager test -count=1 ./internal/agentexec/adapters/...",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto",
|
||||
"before_head": "88f446531beb8702a4a95a41ce581e2d4323604d",
|
||||
"after_head": "88f446531beb8702a4a95a41ce581e2d4323604d",
|
||||
"branch": "feature/cursor-explicit-model-auto",
|
||||
"target_branch": "main",
|
||||
"target_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "b9a88a2e41d0f40d725ae54b2ae633e44b9df560a0a72f7825ebbce88baa5c6e",
|
||||
"after_tracked_diff_sha256": "b9a88a2e41d0f40d725ae54b2ae633e44b9df560a0a72f7825ebbce88baa5c6e",
|
||||
"output_tail": [
|
||||
"ok \tdevelopment-manager/internal/agentexec/adapters\t0.004s"
|
||||
],
|
||||
"output_sha256": "2cffdc38850f97e030e880c45699a6a11b06c2775981af4078ef33f632420023",
|
||||
"receipt_sha256": "8cba28efa634b39f395787b9ab213398c002c0a585221d6f050c77280824a919",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/8cba28efa634b39f395787b9ab213398c002c0a585221d6f050c77280824a919.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T03:57:53.830073+00:00",
|
||||
"command": "make task-sync",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto",
|
||||
"before_head": "e8cf50fb3f9deff94a9499921bacb6e5d2552108",
|
||||
"after_head": "e8cf50fb3f9deff94a9499921bacb6e5d2552108",
|
||||
"branch": "feature/cursor-explicit-model-auto",
|
||||
"target_branch": "main",
|
||||
"target_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto'",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[worktree] before-update: recursive component checks passed",
|
||||
"[worktree] materialize: recursive component checks passed",
|
||||
"[worktree] after-sync: recursive component checks passed",
|
||||
"[evidence] WARN JSON receipt line 121: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[synced] sync_base=ac594c90e536cfb670e94680f045a6c8247a2513 tested_head=e8cf50fb3f9deff94a9499921bacb6e5d2552108 checked_at=2026-10-20T03:58:47Z changed=0 sync_target=main",
|
||||
"[next] 跑正式验收（make test 等），证据写入任务卡",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto'"
|
||||
],
|
||||
"output_sha256": "87c7c6e85e7c7fbae5df8e2fc60123d345e043ab0fe2d822fb07e1a20ed7a39c",
|
||||
"receipt_sha256": "43fcec3baa078cfeeb4b10d9c4f3e0554dba0f27792e1151a225bdf7d91541b1",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/43fcec3baa078cfeeb4b10d9c4f3e0554dba0f27792e1151a225bdf7d91541b1.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T03:58:56.449775+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 2,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto",
|
||||
"before_head": "e8cf50fb3f9deff94a9499921bacb6e5d2552108",
|
||||
"after_head": "e8cf50fb3f9deff94a9499921bacb6e5d2552108",
|
||||
"branch": "feature/cursor-explicit-model-auto",
|
||||
"target_branch": "main",
|
||||
"target_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "4317988e164abd60d49c490603d566068c2fce4ab71bd785fc0cdf2c1b0ebb4f",
|
||||
"after_tracked_diff_sha256": "4317988e164abd60d49c490603d566068c2fce4ab71bd785fc0cdf2c1b0ebb4f",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto'",
|
||||
"[repo] branch=feature/cursor-explicit-model-auto head=e8cf50fb3f",
|
||||
"[remote] origin/main=ac594c90e5 ahead=4 behind=0",
|
||||
"[tree] dirty(1) submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=8",
|
||||
"[cards] 已合入未闭合任务卡:feature-iam-role-permission-linked-capabilities.md——make task-close 回填归档（主检出运行）",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md, standards/collaboration.md（树脏=他人或未收尾现场，不得写入）",
|
||||
"[R0] ac594c90e5（完整：ac594c90e536cfb670e94680f045a6c8247a2513）",
|
||||
"[verdict] SHARED_WORKSPACE_BUSY — 工作树不干净，不得写入；先收尾或经 owner 确认",
|
||||
"make[1]: *** [Makefile:40: precheck] Error 3",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto'"
|
||||
],
|
||||
"output_sha256": "2f0b15c181f2d0683f8c7b71ea16af91ac32206a5dcdaa2723015c8db8742ca2",
|
||||
"receipt_sha256": "ab41cab72ef0a1e70cabdc5dd98152d4173659722144b49cd300d96a8b314af2",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/ab41cab72ef0a1e70cabdc5dd98152d4173659722144b49cd300d96a8b314af2.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T03:59:10.263393+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto",
|
||||
"before_head": "2430123837f52b5a1f23d8f780ab2820662213df",
|
||||
"after_head": "2430123837f52b5a1f23d8f780ab2820662213df",
|
||||
"branch": "feature/cursor-explicit-model-auto",
|
||||
"target_branch": "main",
|
||||
"target_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto'",
|
||||
"[repo] branch=feature/cursor-explicit-model-auto head=2430123837",
|
||||
"[remote] origin/main=ac594c90e5 ahead=5 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=8",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] ac594c90e5（完整：ac594c90e536cfb670e94680f045a6c8247a2513）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-cursor-explicit-model-auto'"
|
||||
],
|
||||
"output_sha256": "6e0be0bead14cab83976c54cf02bb42c7f50ca9a970c936847c7468be0a08249",
|
||||
"receipt_sha256": "74eb543778810cbc85366ba05a047687a2fb4c28758da747b5f4ea1937713e06",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/74eb543778810cbc85366ba05a047687a2fb4c28758da747b5f4ea1937713e06.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（合入前折叠）
|
||||
|
||||
- 本卡在 PR #644（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/644）合入前闭合并归档，随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填，也无需单独的闭合 PR。
|
||||
@@ -0,0 +1,254 @@
|
||||
# feature/docker-test-image 任务卡
|
||||
|
||||
任务主记录：PR #645 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/645；状态：已完成（合入前闭合）；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 162c5a0160955989608f325b4be30458e3717d16
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image（worktree）；分支：feature/docker-test-image
|
||||
- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
|
||||
- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=614aefe70dd97a672de9522beee5fece3da4719ee310d1c7cfc4d13fea081ac2；triage_receipt=/tmp/docker-image-triage.json；receipt_sha256=bc1c9cab074d853273d064a98599c6ef2519aa4022f2272bcc0830d3d97d01c0
|
||||
|
||||
- 授权与交付终点：用户直接请求（2026-10-20）：为本系统准备 Docker 测试镜像（含系统环境、SSH、无头浏览器），后续测试用该镜像启动容器做隔离测试。终点=镜像定义与构建/验证入口合入 main：docker/ 定义文件 + Makefile image-build/image-verify + docker/README.md，镜像本机构建通过、容器内环境自检通过。未授权事项：不改动 modules/**、CI/治理脚本、部署形态（本仓交付仍非容器化）；不发布镜像到外部 registry；不把本镜像用于生产部署。
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段：需求拆解；当前增量：I1（待定义）
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
目标：一份可重复构建的测试环境镜像定义（docker/），镜像内提供与本机开发一致的工具链（Go 1.27.1、Node 26.10.0、Python 3.14、git、make）、SSH 服务（仅公钥、专用 dev 用户）与无头浏览器（Playwright 1.64.0 chromium，系统级缓存 /opt/ms-playwright），供后续以 `docker run` 启动一次性容器、挂载仓库做隔离测试。
|
||||
|
||||
入口/影响：新增 docker/（Dockerfile、entrypoint.sh、verify-env.sh、README.md）；根 Makefile 新增 image-build / image-verify 两个目标。不嵌入仓库代码与任何密钥；不改变 `make test`/CI 行为；不引入部署容器化。
|
||||
|
||||
非目标：镜像注册表发布、CI 内构建镜像、多架构构建、给镜像装业务代码/子模块、Windows/macOS 镜像。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| docker-test-image | docker/**、Makefile | AGENT-EXECUTION.md（agent-execution/v1） | implementation | cursor→antigravity→pi（紧急 codex） | cursor#a1（运行 1） | cursor-agent-stable/auto | failed-unknown（cursor 后端连接反复中断，exit 1） | 未发生 | 无 | /tmp/docker-image-unit1-receipt.json；隔离工作区保留于 /tmp/agent-exec-1000/ebd031a7b7be000aca6f401395d70cd1/wt-bb3cf3ec9e85 |
|
||||
| docker-test-image | 同上（重派发） | 同上 | implementation | 同上 | cursor#a1（运行 2，重发前已对账+探活） | cursor-agent-stable/auto | failed-unknown（Cursor 月度额度耗尽 ActionRequiredError，非瞬时） | 未发生 | 无 | /tmp/docker-image-unit2-receipt.json；隔离工作区保留于 /tmp/agent-exec-1000/90bc3c29e3ea2d9fbebc9e376461846f/wt-c0358fa94a6b |
|
||||
| docker-test-image | 同上（误派发） | 同上 | implementation | 同上 | — | — | invalid-config（运行前检出脏：host 对 AGENT-EXECUTION.md 的直接改动被 admit 拒绝后残留，已回滚，未启动任何候选） | 未发生 | 无 | /tmp/docker-image-unit3-receipt.json |
|
||||
| docker-test-image | 同上（重派发） | AGENT-EXECUTION.md（cursor 停用后，16776aa） | implementation | antigravity→pi（紧急 codex） | agy#a1（运行 4） | antigravity/auto | failed-unknown（实现与验证全部完成、终态记录已输出，但会话尾部一次后端 API EOF 污染 result 信封，控制器 fail-closed 未建 transport；镜像已建成且 verify-env PASS 经 host 独立复核） | 未发生 | 无 | /tmp/docker-image-unit4-receipt.json；隔离区 /tmp/agent-exec-1000/78f91904001532b603bf0ceeb292b893/wt-3ec6b80250c3（含已验证实现） |
|
||||
| docker-test-image | 同上（重验证派发） | 同上 | implementation | 同上 | agy#a2（运行 5，对账后；连续第二次因传输机制的 failed-unknown 重派发，若再失败则回到用户决策，不无限循环） | 待运行 | NOT_RUN | NOT_RUN | NOT_RUN | /tmp/docker-image-unit5-receipt.json |
|
||||
|
||||
- 配置摘要来源：AGENT-EXECUTION.md `agent-execution` 块（schema v1；implementation 候选 cursor/agy/pi，每候选至多 3 次，紧急 codex 一次，fallback_to_host=never）；运行收据由 scripts/agent-exec run 写出后原样保留在源码外路径。
|
||||
- 运行 1 对账（2026-10-20）：镜像未构建（docker images 无 agent-system-test-*）、无新增容器、规范检出干净；改动仅存在于保留的隔离工作区（Makefile M + docker/ 4 文件）；cursor 探活已恢复（探针 exit 0）。据此授权同一单元重新派发（新 run，非同 run 盲重试）。
|
||||
- 运行 2 对账（2026-10-20）：终态原因实为 Cursor Ultra 月度用量额度耗尽（ActionRequiredError，重置日 2026-11-10），属确定性不可用；host 依配置 enabled 机制停用 cursor 时被 pre-commit admit 拒绝（非豁免路径须 transport 来源），路由改动本身又需一次成功运行——死锁，经用户选项 1 解除（见下方决策点）。
|
||||
- 运行 4 对账（2026-10-20）：worker 完成实现且四条验证自报通过，host 独立重跑 `docker run --rm --shm-size=1g agent-system-test-env:dev /usr/local/bin/verify-env.sh` → verify-env: PASS；失败纯属会话尾部 API EOF 污染 result 信封（raw log 尾部 `streamGenerateContent: EOF`），非内容缺陷。镜像 agent-system-test-env:dev 已在 daemon 中（层缓存可复用）。授权重派发运行 5 作纯重验证；若再因传输机制失败，停止并回用户决策。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态：待核对（无适用规划时说明原因）
|
||||
- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文）
|
||||
- 对应里程碑：待核对
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | 测试环境镜像定义：docker/ 内 Dockerfile 固定 ubuntu:24.04（amd64）+ Go 1.27.1 + Node 26.10.0 + Python 3.14（deadsnakes）+ git/make/openssh-server/sudo + Playwright 1.64.0 chromium（/opt/ms-playwright） | 与本机开发工具链版本一致（实测：go1.27.1 / v26.10.0 / 3.14.8 / playwright 1.64.0），避免测试行为漂移 | 高 | `docker build -t agent-system-test-env:dev docker/` 退出 0 | 无 | 已确认 |
|
||||
| R2 | SSH 就绪：容器以 root 入口前台跑 sshd；PermitRootLogin no、PasswordAuthentication no；dev 用户（UID 1000、NOPASSWD sudo）；host key 首启生成；authorized_keys 运行时只读挂载注入 | 隔离测试需要经 SSH 进入容器；公钥注入避免镜像携带凭据 | 高 | 容器内 `sshd -t` 通过；dev 存在且 sudo NOPASSWD；镜像内无任何私钥/secret | R1 | 已确认 |
|
||||
| R3 | 无头浏览器可用：镜像内预装 playwright 1.64.0 chromium 及系统依赖，ENV PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright | frontend e2e（@playwright/test ^1.50.1，解析 1.64.0）容器内可直接跑；版本对齐避免浏览器 revision 漂移 | 高 | verify-env.sh 中 chromium --headless --dump-dom about:blank 输出 HTML | R1 | 已确认 |
|
||||
| R4 | 构建/验证入口与文档：Makefile image-build / image-verify；docker/README.md 覆盖构建、启动（端口映射、--shm-size、公钥挂载、仓库挂载 /workspace）、容器内跑 e2e 示例与安全边界 | 用户后续直接用这两个入口启动隔离测试容器 | 中 | `make image-build`、`make image-verify` 可用；README 含最小可复现命令 | R1–R3 | 已确认 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用：本卡「目标与非目标」+ 单元包 /tmp/unit-docker-test-image.json（digest 由运行收据记录）；固定版本事实：go1.27.1、node v26.10.0、python 3.14.8、playwright 1.64.0（本机实测于 2026-10-20）
|
||||
- 实施计划引用：单单元 docker-test-image（docker/** + Makefile 内聚小任务，合为一个包）
|
||||
- 测试计划引用：R1–R4 验收条件 = worker 窄检查（docker build + 容器内 verify-env.sh）；host 权威验证在 apply 后本仓重跑同两命令
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | R0=162c5a0160 | 已完成 | host 主模型 | 2026-10-20 | AGENTS.md 路由 + policy/delivery.md |
|
||||
| 需求评估 | R0=162c5a0160 | 已完成 | host 主模型 | 2026-10-20 | 本卡需求表 R1–R4 |
|
||||
| 需求表确认 | R0=162c5a0160 | 已完成 | 用户直接请求即授权 | 2026-10-20 | 授权与交付终点节 |
|
||||
| 方案设计 | R0=162c5a0160 | 已完成 | host 主模型 | 2026-10-20 | 见方案与计划 |
|
||||
| 实施计划 | R0=162c5a0160 | 已完成 | host 主模型 | 2026-10-20 | 单元 docker-test-image（单元包 /tmp/unit-docker-test-image.json） |
|
||||
| 实施与自检 | de3d3aff（transport de3d3aff285e0dcfd185c9904a3a9b01af34e2fa） | 已完成 | agy worker（运行 4 实现、运行 5 重验证）→ host apply | 2026-10-20 | /tmp/docker-image-unit5-receipt.json；运行 1–5 详见收据表 |
|
||||
| 正式测试与验收 | de3d3aff | 已完成（SELF；GATE 待 CI） | host 主模型 | 2026-10-20 | make image-build / image-verify 证据入卡；CI 待验 |
|
||||
| 代码 Review | de3d3aff | 进行中 | host 主模型（policy 允许，独立于实施会话） | 2026-10-20 | 见合入与清理节 Review 记录 |
|
||||
| 合入 | de3d3aff | 待执行 | host（授权范围内） | — | 按 policy/delivery.md 合入流程 |
|
||||
| 合入核验与收口 | — | 待执行 | host | — | — |
|
||||
|
||||
### 决策点（2026-10-20，已闭合）
|
||||
|
||||
implementation/repair 角色首候选 cursor 因月度额度耗尽必然失败，且路由配置无法由 host/worker 合规变更。选项及结果：
|
||||
|
||||
1. **已采纳（用户 2026-10-20 选定选项 1）**：用户以自身授权在任务 worktree 编辑 AGENT-EXECUTION.md 将 cursor profile `enabled: false`（附注释，额度重置后恢复），并亲自 `git commit --no-verify` 提交为 16776aa（配置 diff 已在决策菜单中预告并经用户选择，validate 通过）。host 据此重派发，路由落到探活正常的 antigravity。额度重置后应恢复 enabled: true。
|
||||
2. 用户在 Cursor 提高 Spend Limit（未采用）。
|
||||
3. 等待 2026-11-10 重置（未采用）。
|
||||
4. host 以 role=test 派发（未采用，角色标签与工作性质不符）。
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| I1 | docker/ 镜像定义可构建、容器内自检通过 | 单一交付 | build+verify 通过即停，不做镜像优化迭代 | 授权与交付终点节 | NOT_RUN | 待评估 | 待评估 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 162c5a0160955989608f325b4be30458e3717d16 | 162c5a0160955989608f325b4be30458e3717d16 | 2026-10-20T02:39:22Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态：未入队；调度记录：无
|
||||
- entry_id：无；attempt_id：无；窗口执行者：无
|
||||
- 固定候选：无（base/head、组件与相关配置引用实际尝试）
|
||||
- 调度依据：policy/delivery.md#合入调度
|
||||
- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果：docker/ 测试环境镜像定义（Dockerfile + entrypoint.sh + verify-env.sh + README.md）与根 Makefile image-build/image-verify 目标已由 worker 交付、host apply 入分支（de3d3aff）。镜像 ubuntu:24.04 + Go 1.27.1 + Node 26.10.0 + Python 3.14（deadsnakes）+ Playwright 1.64.0 chromium（/opt/ms-playwright）+ sshd（仅公钥、dev 用户 NOPASSWD sudo、root 登录关闭）。
|
||||
- 验证：`make image-build` exit=0（SELF，证据块）；`make image-verify` exit=0 且 verify-env: PASS（SELF）；worker 四条自检通过；R1–R4 验收条件全部满足。已知非阻塞项：Dockerfile `FROM --platform=linux/amd64` 触发 buildkit 一条 lint 警告（有意钉住 amd64，不改）。CI GATE 与 Review 见合入与清理节。
|
||||
- 影响与剩余项：仅新增 docker/ 与 Makefile 两个目标，不触碰 modules/CI/治理脚本；镜像不发布外部 registry。剩余：PR CI、独立 Review、合入与回收。
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余：待核对（依据实际成果更新适用方案/规划）
|
||||
- 首选下一任务：待核对（无适用规划、已完成或受阻时如实说明，不虚构任务）
|
||||
- 推荐依据：待填写
|
||||
- 前置条件/待确认：待核对
|
||||
- 预期产物/验收条件：待定义
|
||||
- 重复任务核对：待核对（已有/在途任务、PR 与规划记录）
|
||||
- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：PASS（host 主模型独立 Review，非实施会话；对象 base=origin/main/d2035c76 head=b9c0fc3）。范围核对：7 文件全部在授权内（docker/ 4 文件 + Makefile 增量 + 任务卡 + AGENT-EXECUTION.md 路由调整 16776aa）；Go/CI/脚本/modules 零触碰；secret 扫描无命中（仅 task-start 等词的 sk- 误报）；Makefile 除 .PHONY 一行外纯增量。非阻塞观察：① FROM --platform=linux/amd64 触发 buildkit lint 警告（有意钉 amd64，接受）；② sshd_config 追加式覆盖依赖 stock ubuntu 默认（测试镜像可接受，verify-env 已断言 sshd -t）。
|
||||
- 冲突记录：main 前进至 d2035c7（含 #644）后合并 origin/main（merge commit b9c0fc3），无冲突；新 gitlink 物化后 make test-worktree 递归核对通过；modules/frontend 仍解析 @playwright/test ^1.50.1（镜像内浏览器 1.64.0 对齐不变）。
|
||||
- CI 记录：CI_SUCCESS @ b9c0fc3fa1817812295394e069b457cc098e1f24（ci / test、test-pg、svc-realcombo 全绿，runs 4360）。过程备注：首候选 HEAD 8e062ca 的 test-pg 首跑 TestArtifactFacadeCard 失败（伴随 database is closed 收尾噪音），重跑同 job 即 success，判偶发；b9c0fc3 的 test 首跑为 npm EIDLETIMEOUT 网络抖动，重跑 success。两次均非本 PR 内容缺陷（本 PR 未触碰 Go/npm 依赖）。
|
||||
- 合入记录：待执行（合入后回填）
|
||||
- 清理记录：待执行（合入后回填）
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T02:38:25.695061+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "162c5a0160955989608f325b4be30458e3717d16",
|
||||
"after_head": "162c5a0160955989608f325b4be30458e3717d16",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "162c5a0160955989608f325b4be30458e3717d16",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=162c5a0160",
|
||||
"[remote] origin/main=162c5a0160 ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=6",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] 162c5a0160（完整：162c5a0160955989608f325b4be30458e3717d16）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "9e1904b7470a27857bd0243bc42faff0a9eb9cafc6916ad823fb1ccfea32f3b3",
|
||||
"receipt_sha256": "838d0ce05fc8661b279c5ccd7696cbe4712cd582b3bf39411ede4265e314a7f1",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/838d0ce05fc8661b279c5ccd7696cbe4712cd582b3bf39411ede4265e314a7f1.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T04:24:06.218569+00:00",
|
||||
"command": "make image-build",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image",
|
||||
"before_head": "de3d3aff285e0dcfd185c9904a3a9b01af34e2fa",
|
||||
"after_head": "de3d3aff285e0dcfd185c9904a3a9b01af34e2fa",
|
||||
"branch": "feature/docker-test-image",
|
||||
"target_branch": "main",
|
||||
"target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"#10 CACHED",
|
||||
"",
|
||||
"#11 exporting to image",
|
||||
"#11 exporting layers done",
|
||||
"#11 exporting manifest sha256:1b70b78c47f81555bca6525d04f8fefa836eb817d37bd018fcd71632c9cce13b done",
|
||||
"#11 exporting config sha256:af4c14981be06d79e082e1685dd6f5aac947bc2f08022de3efdb8a158d656ffb done",
|
||||
"#11 exporting attestation manifest sha256:bebc178b5c4328c737af45858184422a642deb66ac627d6cc80d6ec3c003f246 done",
|
||||
"#11 exporting manifest list sha256:b9244ca7c49a4192b6beee8cb66ea148f2b07d6c26e613f3661aba4e569b6fa4 done",
|
||||
"#11 naming to docker.io/library/agent-system-test-env:dev done",
|
||||
"#11 unpacking to docker.io/library/agent-system-test-env:dev done",
|
||||
"#11 DONE 0.0s",
|
||||
"",
|
||||
" \u001b[33m1 warning found (use docker --debug to expand):",
|
||||
"\u001b[0m - FromPlatformFlagConstDisallowed: FROM --platform flag should not use constant value \"linux/amd64\" (line 1)",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image'"
|
||||
],
|
||||
"output_sha256": "9d5d28f761a75ec302f735b181d53f3a31893b29a7db1417da0b580d39a6ede9",
|
||||
"receipt_sha256": "10c826d7803683685c0fe49e99b8a86a04e0d675b14aad637f50220a48b13d58",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/10c826d7803683685c0fe49e99b8a86a04e0d675b14aad637f50220a48b13d58.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T04:24:15.223285+00:00",
|
||||
"command": "make image-verify",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image",
|
||||
"before_head": "de3d3aff285e0dcfd185c9904a3a9b01af34e2fa",
|
||||
"after_head": "de3d3aff285e0dcfd185c9904a3a9b01af34e2fa",
|
||||
"branch": "feature/docker-test-image",
|
||||
"target_branch": "main",
|
||||
"target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image'",
|
||||
"docker run --rm --shm-size=1g agent-system-test-env:dev /usr/local/bin/verify-env.sh",
|
||||
"verify-env: PASS",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-docker-test-image'"
|
||||
],
|
||||
"output_sha256": "4e670ae97df841f706396291f73ef43e7702f9fd60cfe163b37699ca5968804a",
|
||||
"receipt_sha256": "3c69f4644d10998f86733da4486b1967e49c310aad4a932aa13a7bddaf387265",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/3c69f4644d10998f86733da4486b1967e49c310aad4a932aa13a7bddaf387265.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（合入前折叠）
|
||||
|
||||
- 本卡在 PR #645（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/645）合入前闭合并归档，随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填，也无需单独的闭合 PR。
|
||||
@@ -0,0 +1,166 @@
|
||||
# feature/fast-slow-o2-i1-agent-native 任务卡
|
||||
|
||||
任务主记录：PR #647 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/647；Dev 草稿 PR [#647](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/647)；状态：已完成（合入前闭合）；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= ac594c90e536cfb670e94680f045a6c8247a2513
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-fast-slow-o2-i1-agent-native（worktree）；分支：feature/fast-slow-o2-i1-agent-native
|
||||
- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
|
||||
- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=24717af8dcc91e7b1fbe4ceb92919ea31e43da66f46e51371e9ea2102d8b8cc5；triage_receipt=/tmp/o2i1-20261020/triage.json；receipt_sha256=7854667c4867dabc655b1ce4d1b8f026da6de0e2929fb26b4374353089474fa7
|
||||
|
||||
- 授权与交付终点：用户 2026-10-20 阶段 4/5 人审“通过”（[方案](docs/superpowers/specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md) §6.1 选 C2 同时接受 `http2_stream` 与 `known_length`+`match`；§6.2 配置仅系统层、默认关闭），并要求启动 I1。终点：Agent-Native I1 草稿 PR 经独立 Review 与 CI 通过 + 阶段 6 评审包，待用户阶段 6 人审后再合入。未授权：I2/I3 启动前另行确认、P1 付费探针（另提资源方案）、部署、真实模型/付费请求。
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段：实施与自检；当前增量：I1（Agent-Native 分支 feature/fast-slow-o2-i1-route-contract，base origin/main 9c24e22）
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
- 目标：对一条精确绑定的 OpenAI 兼容路由（模型 + 规范化基址 + 摘要），在流缺字面 `[DONE]` 但 C1–C9 全部成立时放行工具调用，终态标 `CompletionBasis=route_contract_eof`；合同为零值时行为逐字节等同现状。
|
||||
- 受影响：Agent-Native `runtime/llm`（`Client.RouteContract`、解析器延后判定、`Event`/`TerminalObservation` 新增 `completionBasis`/`contractCheck`）、新包 `runtime/argschema`、`runtime/tools/registry.go` 委托校验。
|
||||
- 非目标：不改 `StreamComplete` 语义；不泛化到其他路由/协议；Backend 配置与透传（I2）、Dev 改钉（I3）、付费探针（P1）不在本卡。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| o2-i1-agent-native-route-contract | runtime/llm、runtime/argschema、registry.go(+test) | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 1 | cursor / auto | scope-expansion（单元包 `allowed_paths` 误用 `**` 通配，执行器按前缀匹配，7 个范围内文件被判越界；fail-stop） | 未集成 | never | /tmp/o2i1-20261020/o2-i1-receipt.attempt1-scope-expansion.json |
|
||||
| o2-i1-agent-native-route-contract | 同上（改为前缀写法 `runtime/llm/`、`runtime/argschema/`，范围不变） | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 2（用户 2026-10-20 授权全新重跑） | cursor / auto | success | `899fd70`（ref refs/agent-exec/e38bcf1c…/445c377b，parent 9c24e22），`agent-exec apply` 快进集成 | never | /tmp/o2i1-20261020/o2-i1-receipt.json |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态：待核对（无适用规划时说明原因）
|
||||
- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文）
|
||||
- 对应里程碑：待核对
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | I1：Agent-Native `route_contract_eof` 限路由等价终态 | 符合：用户 2026-10-19 选定 O2，2026-10-20 阶段 4/5 通过 | P1 | 计划 §2 测试矩阵全部用例通过；拒绝时终态事件除 `contractCheck` 外与合同关闭 deep-equal；零值合同行为不变；现有断言不删减 | 无 | 实施中 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用：docs/superpowers/specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md（Dev main，PR #639 合入）
|
||||
- 实施计划引用：docs/superpowers/plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md §2（I1）
|
||||
- 测试计划引用：同上 §2 测试表与验证命令
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 待定 | 待执行 | — | — | — |
|
||||
| 需求评估 | 待定 | 待执行 | — | — | — |
|
||||
| 需求表确认 | 待定 | 待执行 | — | — | — |
|
||||
| 方案设计 | Dev 5a7a0da | 通过（C2 接受 known_length+match） | 用户 | 2026-10-20 | 阶段 4 人审 |
|
||||
| 实施计划 | Dev 5a7a0da | 通过 | 用户 | 2026-10-20 | 阶段 5 人审 |
|
||||
| 实施与自检 | Agent-Native 899fd70 | 完成（SELF） | cursor worker 实施；host 范围审阅与验证 | 2026-10-20 | 收据 o2-i1-receipt.json |
|
||||
| 正式测试与验收 | Agent-Native 899fd70 | 阶段 6 通过（接受 C2 编号） | 用户 | 2026-10-20 | PR #48 CI GATE success；评审包 2026-10-20-fast-slow-o2-i1-review.md |
|
||||
| 代码 Review | Agent-Native 899fd70 | PASS | 全新会话 code-reviewer | 2026-10-20 | 见合入与清理节 |
|
||||
| 合入 | Agent-Native 2fc66be | 已合入 Agent-Native main | host | 2026-10-20 | 用户阶段 6 授权 |
|
||||
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | ac594c90e536cfb670e94680f045a6c8247a2513 | ac594c90e536cfb670e94680f045a6c8247a2513 | 2026-10-20T03:22:13Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态：未入队；调度记录：无
|
||||
- entry_id：无；attempt_id：无；窗口执行者：无
|
||||
- 固定候选：无（base/head、组件与相关配置引用实际尝试）
|
||||
- 调度依据：policy/delivery.md#合入调度
|
||||
- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果：I1 在 Agent-Native 分支 `feature/fast-slow-o2-i1-route-contract`（`899fd70`，草稿 PR #48）交付；阶段 6 评审包 docs/superpowers/specs/2026-10-20-fast-slow-o2-i1-review.md。
|
||||
- 验证：host（SELF）@899fd70 vet、定向测试（含 -race）、`go test ./...` PASS；CI（GATE）PR #48 三项 success；独立 Review PASS。
|
||||
- 影响与剩余项：仅 Agent-Native `runtime/llm`、`runtime/argschema`、registry 委托；合同默认关闭。剩余：用户阶段 6；I2、I3、P1；评审包第 3 节非阻塞项。
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余：待核对（依据实际成果更新适用方案/规划）
|
||||
- 首选下一任务：待核对（无适用规划、已完成或受阻时如实说明，不虚构任务）
|
||||
- 推荐依据：待填写
|
||||
- 前置条件/待确认：待核对
|
||||
- 预期产物/验收条件：待定义
|
||||
- 重复任务核对：待核对（已有/在途任务、PR 与规划记录）
|
||||
- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：Cursor Task 子代理 code-reviewer（fresh_session=true，session=531ce711-73e7-44d8-8b9e-ed90d93856f7；只接收需求、方案/计划、base 9c24e22/head 899fd70 与 diff，未转交实施会话）；结论 PASS，0 阻塞，3 条非阻塞记入评审包第 3 节；评审者自跑 vet 与 -race 定向测试通过（SELF）。
|
||||
- CI 记录（Agent-Native）：PR #48 head `899fd70d27dd25bb88088a677546a71e54a86d9e` commit status success：`ci / vet-and-test`（runs/4350/jobs/7018）、`ci / docker-checkout-hostgateway`（runs/4350/jobs/7019）、`governance / governance`（runs/4351/jobs/7020）（GATE）。
|
||||
- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测）
|
||||
- CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果）
|
||||
- 合入记录（Agent-Native）：用户 2026-10-20 阶段 6 通过；PR #48 核验 head `899fd70`、commit status success（3 项，GATE）后合入 Agent-Native main，合入提交 `2fc66be65201232ea38ba64d457efad5565d869d`；合入后 tree `720ec93` 与合入前 `git merge-tree` 预期一致。Dev 改钉在 I3 组合验证。
|
||||
- 合入记录（本 PR）：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验）
|
||||
- 清理记录：Agent-Native worktree `Agent-Native-wt-feature-fast-slow-o2-i1` 核验无写者、干净后移除，本地分支已删；Dev worktree 待本 PR 合入后回收。
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T03:21:23.593016+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"after_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "ac594c90e536cfb670e94680f045a6c8247a2513",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=ac594c90e5",
|
||||
"[remote] origin/main=ac594c90e5 ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=7",
|
||||
"[cards] 已合入未闭合任务卡:feature-iam-role-permission-linked-capabilities.md——make task-close 回填归档（主检出运行）",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] ac594c90e5（完整：ac594c90e536cfb670e94680f045a6c8247a2513）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "8354ba7addbd3c5505eb65459b25cc49dc9c6513d9a4e8f6b38dc9f448b3f478",
|
||||
"receipt_sha256": "a0e06fafe3a01436440290d8fe41abd0581c817dde2ad3481497f95cae50a473",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/a0e06fafe3a01436440290d8fe41abd0581c817dde2ad3481497f95cae50a473.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（合入前折叠）
|
||||
|
||||
- 本卡在 PR #647（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/647）合入前闭合并归档，随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填，也无需单独的闭合 PR。
|
||||
| 同步（记录前对象） | d2035c76dc1cb15e01d2c184af5155d9d773cd9f | 014655339962c1057970ddc9ce9e2025fe31f902 | 2026-10-20T05:56:34Z |
|
||||
| 同步（记录前对象） | f97917032d143188bc7faf665aff612d9814af4e | a577c9e11bae5655fc63a9ca313c84e70ad24aed | 2026-10-20T06:55:48Z |
|
||||
@@ -0,0 +1,164 @@
|
||||
# feature/fast-slow-o2-i2-backend 任务卡
|
||||
|
||||
任务主记录：PR #652 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/652；状态：已完成（合入前闭合）；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= d2035c76dc1cb15e01d2c184af5155d9d773cd9f
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-fast-slow-o2-i2-backend（worktree）；分支：feature/fast-slow-o2-i2-backend
|
||||
- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
|
||||
- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=95d3a2ee34b8bdcabd1222b2ffbad0031a98717338fa400b8d7367d9d7d91610；triage_receipt=/tmp/o2i2-20261020/triage.json；receipt_sha256=88c443107094b249c62de6b88b0d3503d8caa4e420b802ebc4002dc58bb9250e
|
||||
|
||||
- 授权与交付终点：用户 2026-10-20 在 O2 I1 阶段 6 结论中选择“通过并启动 I2”（方案/计划阶段 4/5 已于同日通过）。终点：Backend I2 草稿 PR 经独立 Review 与 CI 通过 + 阶段 6 评审包，待用户阶段 6 人审后再合入。未授权：I3 Dev 改钉（I2 通过后启动）、P1 付费探针、写入任何实例的系统层配置、部署、真实模型/付费请求。
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段：实施与自检；当前增量：I2（Backend 分支 feature/fast-slow-o2-i2-route-contract，base origin/main b5eb89c）
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
- 目标：Backend 以系统层三键 `models.routeContractEOF.model/.baseUrl/.identitySha256`（默认空 = 关闭）声明 O2 路由合同；5 个 `openLLMClient` 调用点统一按各自解析出的 (model, base) 精确判定是否挂 `RouteContractEOF`；`deps/agent-native` 改钉到 I1 合入提交 `2fc66be`。
|
||||
- 受影响：Backend `internal/runtime`（`openRouteClient`/`routeContractFor`）、`internal/settings/settings.go`、`deps/agent-native` gitlink。
|
||||
- 非目标：不改 Agent-Native；不写入任何实例配置；`runmgr` 无需改动（Backend 生产代码不记录终态字段，快慢通道收据由测试侧评估工具记录整个 `terminalObservation`，改钉后自动包含 `completionBasis`）；Dev 改钉（I3）、付费探针（P1）不在本卡。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| o2-i2-backend-route-contract-config | deps/agent-native、internal/runtime/、internal/settings/ | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 1 | — | invalid-config（host 把写单元包与派发并行执行，执行器读包时文件尚不存在；attempts 为空，无任何改动；fail-stop） | 未集成 | never | /tmp/o2i2-20261020/o2-i2-receipt.attempt1-invalid-config.json |
|
||||
| o2-i2-backend-route-contract-config | 同上 | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 2（用户 2026-10-20 授权全新重跑） | cursor / auto | success | `e1a90a5`（ref refs/agent-exec/8eed31d0…/d97e9636，parent b5eb89c），`agent-exec apply` 快进集成 | never | /tmp/o2i2-20261020/o2-i2-receipt.json |
|
||||
| o2-i2b-eval-receipt-route-contract | internal/runtime/llm.go、internal/server/work_checkpoint_eval_test.go、internal/server/work_checkpoint_eval_route_contract_test.go | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 1 | cursor / auto | failed-unknown（worker exit 1，原始日志末尾 `RetriableError: [internal] HTTP/2 keepalive ping timed out after 5000ms`；变更仅在允许路径内但未完成，执行器无法机械对账外部副作用；fail-stop，未换候选） | 未集成 | never | /tmp/o2i2-20261020/o2-i2b-receipt.attempt1-failed-unknown.json |
|
||||
| o2-i2b-eval-receipt-route-contract | 同上 | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi | 2（用户 2026-10-20 07:54 对“授权全新重跑（推荐）”回复“继续”） | cursor / auto | success（219s） | `16f98b8`（ref refs/agent-exec/4792e791…/c578cdde，parent e1a90a5），`agent-exec apply` 快进集成 | never | /tmp/o2i2-20261020/o2-i2b-receipt.json |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态：待核对（无适用规划时说明原因）
|
||||
- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文）
|
||||
- 对应里程碑：待核对
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | I2：Backend 系统层合同配置与按身份挂合同 | 符合：O2 阶段 4/5 通过；I1 阶段 6 通过（Agent-Native #48 合入 2fc66be） | P1 | 计划 §3 测试全部通过：缺省关闭；用户层写入被忽略；模型/基址/摘要任一不符不挂；视觉改模/轻量档独立判定；挂合同后假流放行一次工具并记 `route_contract_eof`；删除配置恢复拒绝；现有断言不删减 | I1 | 实施中 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用：docs/superpowers/specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md §4.5（Dev main，PR #639）
|
||||
- 实施计划引用：docs/superpowers/plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md §3（I2）
|
||||
- 测试计划引用：同上 §3 测试与验证命令
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 待定 | 待执行 | — | — | — |
|
||||
| 需求评估 | 待定 | 待执行 | — | — | — |
|
||||
| 需求表确认 | 待定 | 待执行 | — | — | — |
|
||||
| 方案设计 | 待定 | 待执行 | — | — | — |
|
||||
| 实施计划 | 待定 | 待执行 | — | — | — |
|
||||
| 实施与自检 | Backend `16f98b8` | 完成 | Cursor worker ×2 单元 + host 验证 | 2026-10-20 | 收据表；host SELF 验证见评审包 §2 |
|
||||
| 正式测试与验收 | Backend `16f98b8` | 用户阶段 6 通过 | 用户 | 2026-10-20 08:06 | 用户对“通过：合入 #224 和 #652，并启动 I3（推荐）”回复“继续”；评审包 docs/superpowers/specs/2026-10-20-fast-slow-o2-i2-review.md |
|
||||
| 代码 Review | `e1a90a5` / `16f98b8` | PASS | 独立子智能体 8b8edce1（第 1 轮 PASS-with-fixes）、b0f773ba（第 2 轮 PASS） | 2026-10-20 | 见合入与清理节 Review 记录 |
|
||||
| 合入 | Backend #224 | 已合入 `c164950` | host（agent） | 2026-10-20 | 见合入记录 |
|
||||
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | d2035c76dc1cb15e01d2c184af5155d9d773cd9f | d2035c76dc1cb15e01d2c184af5155d9d773cd9f | 2026-10-20T06:05:02Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态：未入队；调度记录：无
|
||||
- entry_id：无；attempt_id：无；窗口执行者：无
|
||||
- 固定候选：无（base/head、组件与相关配置引用实际尝试）
|
||||
- 调度依据：policy/delivery.md#合入调度
|
||||
- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果：
|
||||
- 验证：<结论摘要 PASS/FAIL/SKIP/NOT_RUN 逐项；逐条证据由 make evidence 写入上方证据表>
|
||||
- 影响与剩余项：
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余：待核对（依据实际成果更新适用方案/规划）
|
||||
- 首选下一任务：待核对（无适用规划、已完成或受阻时如实说明，不虚构任务）
|
||||
- 推荐依据：待填写
|
||||
- 前置条件/待确认：待核对
|
||||
- 预期产物/验收条件：待定义
|
||||
- 重复任务核对：待核对（已有/在途任务、PR 与规划记录）
|
||||
- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：第 1 轮——全新独立 Cursor 子智能体（agent 8b8edce1，fresh_session=true，只接收目标/计划/base b5eb89c..head e1a90a5 diff/CI），结论 PASS-with-fixes：5 条单元验收均满足（本地 SELF 重放 vet、`go test -race ./internal/runtime ./internal/settings`、gofmt、diff --check 通过）。阻塞（相对已批准计划 §3 I2“运行记录与快慢通道收据透传 completionBasis”，host 写单元包时漏列）：`internal/server/work_checkpoint_eval_test.go` 的 `evalProviderStream` 直接构造 Client 不挂合同，`evalTerminalObservation`/`evalCallRecord` 白名单丢 `CompletionBasis`/`ContractCheck`。处置：属已批准 I2 范围，补派单元 `o2-i2b-eval-receipt-route-contract`。非阻塞（只记录）：`internal/app/app.go:350` 小队内核直接构造 Client（不在批准的 5 个调用点内，维持失败关闭）；`app.go:519` 意图生成器无合同无影响；5 个调用点与 `Execute` 的 nil-stream 分支靠审读确认；`settings.go` baseUrl 说明未提 fragment/userinfo。第 2 轮——全新独立 code-reviewer 子智能体（agent b0f773ba，fresh_session=true，只接收需求与 e1a90a5..16f98b8 diff），结论 **PASS，无阻塞项**：生产代码零行为变化（仅导出薄封装）；评测判定经真实 settings 服务 `SetSystemOverride`+`Effective` 与生产同源；白名单无泄漏路径（含 PRIVATE_/C10/大小写反例）；不匹配失败关闭；既有断言未删减。评审者重放（REPLAY）：`go vet -tags live ./internal/server`、`go test -tags live ./internal/server -run 'TestEval|TestEvaluation|TestExtraA01|TestFollowupA01|TestMechanism'`、`go test ./internal/runtime` 均通过。非阻塞：配置了 `routeContractEOF` 却未挂上时评测静默按无合同运行（建议 P1 前改为 t.Fatal，避免浪费付费请求）；合同对象未知键被静默丢弃。
|
||||
- 冲突记录：Backend #224 合入前 origin/main（b5eb89c）是 head 的祖先，无冲突；Dev 侧见同步记录。
|
||||
- CI 记录（Backend #224，GATE）：head `16f98b8e4fbc413d65e2d76b761ffe19afc65a67` 全部 success——`ci / vet-and-test`（/weichen/Agent-System-Backend/actions/runs/4409/jobs/7158）、`governance / governance`（runs/4410/jobs/7159）；前一 head `e1a90a5` 亦 success（runs/4382/jobs/7104、runs/4383/jobs/7105）。注意：CI 跑 `go vet ./... && go test ./...`，不含 `live` tag，评测文件 `internal/server/work_checkpoint_eval*_test.go` 的测试只有 host SELF（`go test -tags live ./internal/server` 24 项通过）与评审重放。
|
||||
- 合入记录：Backend PR #224（授权：用户 2026-10-20 08:06 阶段 6 通过）被核验 HEAD `16f98b8e4fbc413d65e2d76b761ffe19afc65a67`（CI success），合入 Agent-System-Backend main，merge commit `c16495006dbf1cf6ee581b48d99bba1e7f9a377c`，main tree `43129de` 与被核验 HEAD tree 一致。Dev 侧 gitlink 改钉由 I3 负责。
|
||||
- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T06:04:02.239270+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"after_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "d2035c76dc1cb15e01d2c184af5155d9d773cd9f",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=d2035c76dc",
|
||||
"[remote] origin/main=d2035c76dc ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=8",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] d2035c76dc（完整：d2035c76dc1cb15e01d2c184af5155d9d773cd9f）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "32e2a7ee7d89e931af5b2d76a480bf3ccfb9367bff3bc01a91df24649e3a09d8",
|
||||
"receipt_sha256": "c2a4c48509432276fcb5c41d14a8e62e01dda2248d6e49da03b8438114e3650d",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/c2a4c48509432276fcb5c41d14a8e62e01dda2248d6e49da03b8438114e3650d.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（合入前折叠）
|
||||
|
||||
- 本卡在 PR #652（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/652）合入前闭合并归档，随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填，也无需单独的闭合 PR。
|
||||
| 同步（记录前对象） | adbef2f49c6c252a09449496afbdb6685201993b | c70ebf53bfac50b460707d7eb6f482f20e697701 | 2026-10-20T08:08:33Z |
|
||||
@@ -0,0 +1,165 @@
|
||||
# feature/fast-slow-o2-i3-repin 任务卡
|
||||
|
||||
任务主记录：PR #653 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/653；状态：已完成（合入前闭合）；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= adbef2f49c6c252a09449496afbdb6685201993b
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-fast-slow-o2-i3-repin（worktree）；分支：feature/fast-slow-o2-i3-repin
|
||||
- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
|
||||
- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=8dcd51b91a010e321fa05269fd41d0d283d5d1f381da03127748631799667b15；triage_receipt=/tmp/o2i3-20261020/triage.json；receipt_sha256=29e82b237f2fe8ca0bb9dbae8edcdc62403b2f51ca72c718b81d70719aad7c2e
|
||||
|
||||
- 授权与交付终点：用户 2026-10-20 08:06 在 O2 I2 阶段 6 中对“通过：合入 #224 和 #652，并启动 I3（推荐）”回复“继续”。终点：Dev 改钉 `deps/agent-native`、`modules/backend`（及 `check-pins` 强制要求的连锁 `deps/agent-squad`），`make test`+`make build` 由 PR CI（GATE）确认后经 #518 窗口合入 main。未授权：P1 付费探针、写入任何实例的系统层配置、部署、真实模型/付费请求。
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段：实施；当前增量：I3（计划 §4）
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
- 目标：Dev main 组合包含 Agent-Native `2fc66be`（O2 I1）与 Backend I2 合入点，`make test` 通过；默认关闭，行为不变。
|
||||
- 连锁改钉（`scripts/check-pins.sh` 强制各容器嵌套钉与 Dev 一致；先例 `234aa28`/`579a6fe`）：Agent-Squad 嵌套 `deps/agent-native` 28f3ea7→2fc66be（Agent-Squad #55）→ Backend `deps/agent-squad` 改到 Agent-Squad 合入点（Backend 新 PR）→ Dev 一次改钉 `deps/agent-native`、`deps/agent-squad`、`modules/backend`。全部仅 gitlink，无产品代码改动。
|
||||
- 非目标：P1 付费探针、系统层配置写入、部署；O2 已记录的非阻塞项。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| o2-i3a-agent-squad-native-pin（Agent-Squad 仓） | deps/agent-native | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto | success（34s） | `ad58d0a`（ref refs/agent-exec/1695a49c…/559ef8a7，parent c0ce10a），`agent-exec apply` 快进集成 | never | /tmp/o2i3-20261020/o2-i3a-receipt.json |
|
||||
| o2-i3b-backend-squad-pin（Backend 仓） | deps/agent-squad | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto | success | `74f655c`（ref refs/agent-exec/70cdf684…/fcc4d2e0，parent c164950），`agent-exec apply` 快进集成 | never | /tmp/o2i3-20261020/o2-i3b-receipt.json |
|
||||
| o2-i3c-dev-repin（Dev） | deps/agent-native、deps/agent-squad、modules/backend | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto | success（46s） | `76c1c33`（ref refs/agent-exec/cba05e49…/b41a05cf，parent 409f476），`agent-exec apply` 快进集成；host `bash scripts/check-pins.sh` → pins ok | never | /tmp/o2i3-20261020/o2-i3c-receipt.json |
|
||||
| o2-i3d-backend-search-deadlock-test-pg（Backend 仓，扩围授权） | internal/store/search_deadlock_run_timing_test.go | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto | success | `9b23713`（ref refs/agent-exec/245f757e…/1faa105e，parent bb9274d），`agent-exec apply` 快进集成；host SQLite 下 `go test ./internal/store -run TestSearchDeadlockRegression` 通过 | never | /tmp/o2i3-20261020/o2-i3d-receipt.json |
|
||||
| o2-i3e-dev-backend-repin（Dev） | modules/backend | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto | success | `0ab8f8c`（ref refs/agent-exec/304f0c46…/bb83de1c，parent e799650），`agent-exec apply` 快进集成；check-pins ok | never | /tmp/o2i3-20261020/o2-i3e-receipt.json |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态：待核对（无适用规划时说明原因）
|
||||
- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文）
|
||||
- 对应里程碑：待核对
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | I3：Dev 改钉 O2 组合 | 符合：O2 计划 §4；I1、I2 阶段 6 均通过 | P1 | Dev PR HEAD 上 CI `test`/`test-pg`/`svc-realcombo` 全部 success（含 check-pins）；diff 只含 gitlink | I1、I2 合入 | 实施中 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用：docs/superpowers/specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md
|
||||
- 实施计划引用：docs/superpowers/plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md §4（I3）
|
||||
- 测试计划引用：同上 §4：`make test` + `make build` 由 PR CI 确认
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 待定 | 待执行 | — | — | — |
|
||||
| 需求评估 | 待定 | 待执行 | — | — | — |
|
||||
| 需求表确认 | 待定 | 待执行 | — | — | — |
|
||||
| 方案设计 | 待定 | 待执行 | — | — | — |
|
||||
| 实施计划 | 待定 | 待执行 | — | — | — |
|
||||
| 实施与自检 | 待定 | 待执行 | — | — | — |
|
||||
| 正式测试与验收 | 待定 | 待执行 | — | — | — |
|
||||
| 代码 Review | 待定 | 待执行 | — | — | — |
|
||||
| 合入 | 待定 | 待执行 | — | — | — |
|
||||
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 扩围：Backend #223 测试方言缺陷 | Dev #653 @a64a68b CI `test-pg`（runs/4432/jobs/7197）确定性失败：Backend #223（其他会话，已在 Backend main）新增的 `TestSearchDeadlockRegression` 在 PostgreSQL 上调用仅限 SQLite 的 `searchKnowledgeFTSCandidates`（`syntax error at or near "MATCH"`）；Backend CI 不跑 PG 未拦截；O2 I2 合在其上，改钉无法绕开。同 run `test` 失败为 npm ECONNRESET（runner 网络） | Backend `internal/store/search_deadlock_run_timing_test.go` 单文件，仅测试；生产代码不动 | 非 SQLite 方言跳过仅限 SQLite 的步骤后，Dev 组合 `test-pg` 通过即停 | 用户 2026-10-20 授权最小扩围（AskQuestion i3pg=fix_min） | Backend #227 合入 `d8923f1`（期间 main 被其他会话 #226 推进，已合并 main 后在 `803d64e` 重跑 CI 通过）；Dev 改钉 modules/backend → d8923f1 | Dev 需再改钉 modules/backend 到修复合入点 | Dev 组合 CI 重跑 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | adbef2f49c6c252a09449496afbdb6685201993b | adbef2f49c6c252a09449496afbdb6685201993b | 2026-10-20T08:53:44Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态：未入队；调度记录：无
|
||||
- entry_id：无；attempt_id：无；窗口执行者：无
|
||||
- 固定候选：无（base/head、组件与相关配置引用实际尝试）
|
||||
- 调度依据：policy/delivery.md#合入调度
|
||||
- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果：
|
||||
- 验证：<结论摘要 PASS/FAIL/SKIP/NOT_RUN 逐项；逐条证据由 make evidence 写入上方证据表>
|
||||
- 影响与剩余项：
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余：待核对（依据实际成果更新适用方案/规划）
|
||||
- 首选下一任务：待核对（无适用规划、已完成或受阻时如实说明，不虚构任务）
|
||||
- 推荐依据：待填写
|
||||
- 前置条件/待确认：待核对
|
||||
- 预期产物/验收条件：待定义
|
||||
- 重复任务核对：待核对（已有/在途任务、PR 与规划记录）
|
||||
- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：全新独立 code-reviewer 子智能体（agent 9c6a14b3，fresh_session=true，只接收需求、各仓 base/head 与 diff），结论 **PASS，无阻塞项**：Agent-Squad c0ce10a..c7121bd、Backend c164950..bb9274d、Dev 409f476..76c1c33 均只含指定 gitlink；目标 SHA 均在各自 origin/main；Agent-Native 28f3ea7..2fc66be 实际内容只有 O2 I1；评审者重放 `bash scripts/check-pins.sh` → pins ok（REPLAY）。非阻塞（已处置/记录）：① `modules/backend` 改钉顺带引入已在 Backend main 合入的 #222（IAM U5 集成测试，仅测试）与 #223（store 层多用户协作修复）——此后又因扩围引入 #226（其他会话的 CI 不稳定测试修复）与 #227（本任务的 PG 方言测试修复）；Dev diff 本身仍只有 gitlink，行为由组合 CI `make test`/`test-pg` 兜底；U5 归档卡“待 bump Dev modules/backend”随本 PR 实际结清（不改该卡）。② check-pins 8 条 development-guidelines/manager 嵌套钉 warn 为既有状态。③ 合入前 task-sync。④ Dev #634 将来需自行解决 modules/backend gitlink 冲突。#227 的测试方言修复由 host 范围审阅并经本 PR 组合 CI `test-pg` 实测。
|
||||
- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测）
|
||||
- CI 记录：@a64a68b `test-pg` 失败（#223 PG 方言缺陷，见探索试验与迭代）与 `test` 失败（npm ECONNRESET）；@6b78511 `test`/`test-pg`/`svc-realcombo` 全部 success（组合含 Backend d8923f1）。最终 HEAD 的 CI 见合入记录。
|
||||
- 合入记录（组件连锁）：Agent-Squad PR #55 被核验 HEAD `ad58d0ab1a915675e1c7692c0ebb59d48416b655`（CI vet-and-test/docker-checkout-hostgateway/governance success）→ merge `c7121bda2a681dc46078350f7929e56e142db57f`，tree 一致；Backend PR #225 被核验 HEAD `74f655c30ac835920a2d278ebd6dc418280ae01b`（CI vet-and-test/governance success）→ merge `bb9274d737f853474237934bcf25669fd8d6cadb`，tree 一致。两者均只改 gitlink，目标内容（Agent-Native 2fc66be）已在 I1 独立评审。Backend PR #227（扩围修复）被核验 HEAD `803d64e8a2342c6722b696e373c87bc212a62533`（CI vet-and-test/governance success；首轮 `9b23713` 的 vet-and-test 因既有不稳定用例 TestProjectEventsSharedProofAndPrivatePagination 失败，重跑通过）→ merge `d8923f18eceeb476507b09467c0e730ddafc8221`，tree 一致。Dev 合入：待定。
|
||||
- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-20T08:52:56.204072+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "adbef2f49c6c252a09449496afbdb6685201993b",
|
||||
"after_head": "adbef2f49c6c252a09449496afbdb6685201993b",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "adbef2f49c6c252a09449496afbdb6685201993b",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=adbef2f49c",
|
||||
"[remote] origin/main=adbef2f49c ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=6",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] adbef2f49c（完整：adbef2f49c6c252a09449496afbdb6685201993b）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "11058c4bea77919221946183196ce5a97c24fc0bbab8d56ce68de1b1d4ec20ac",
|
||||
"receipt_sha256": "fc66eec2b412ae9a3bfb3afe7f489227201bd35f59c942d555d4dac482e4879f",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/fc66eec2b412ae9a3bfb3afe7f489227201bd35f59c942d555d4dac482e4879f.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（合入前折叠）
|
||||
|
||||
- 本卡在 PR #653（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/653）合入前闭合并归档，随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填，也无需单独的闭合 PR。
|
||||
| 同步（记录前对象） | a4fa1bb518dd13f2efb9bfab8fdf10e15ddeab22 | b2b45d623faba5770993be35003723500861c752 | 2026-10-20T09:41:50Z |
|
||||
@@ -0,0 +1,161 @@
|
||||
# feature/fast-slow-o2-route-contract-eof 任务卡
|
||||
|
||||
任务主记录：PR #639 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/639；状态：已完成（合入前闭合）；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 2b7fdc39a1f44163f4766701429d61ffd6926f1a
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-fast-slow-o2-route-contract-eof（worktree）；分支：feature/fast-slow-o2-route-contract-eof
|
||||
- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false
|
||||
- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=6fc124cc90d04f78b09f649f482b1d37e33158e1a6f6f4821e252654a7bf3a1c；triage_receipt=/tmp/leftover-20261019b/o2-triage.json；receipt_sha256=b93713ab306413aaa7ea484be10767631a3b04db22b133818012ffef3019a19c
|
||||
|
||||
- 授权与交付终点：用户 2026-10-19“授权…另起 O2”（选定评估稿方案 O2）；本轮终点：阶段 4 方案 + 阶段 5 计划经独立 Review、PR/CI 后经 #518 合入 main，并提交用户阶段 4/5 人审。未授权：产品代码、付费/真实模型请求、A01 复验、部署、设置写入。
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段：方案设计/实施计划（待阶段 4/5 人审）；当前增量：无（I1–I3 待人审通过后启动，P1 付费另行授权）
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
- 目标：为一条经核验的 MiniMax 路由定义默认关闭的等价终态 `route_contract_eof`，在缺 `[DONE]` 但满足 C1–C9 时放行工具调用；其余情形保持拒绝。
|
||||
- 本轮产物：方案 `docs/superpowers/specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md`、计划 `docs/superpowers/plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md`。
|
||||
- 非目标：不改代码、不泛化到其他路由、不改 `StreamComplete` 语义、不发付费请求。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| 待定义 | — | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | — |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态：待核对（无适用规划时说明原因）
|
||||
- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文）
|
||||
- 对应里程碑：待核对
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | 限路由等价终态 O2 的方案与计划 | 符合：用户 2026-10-19 选定 O2；r0.6 设计要求先另行方案评审 | P1 | 方案覆盖评估稿 O2 全部条件且只绑定单一路由；计划给出零付费单元、测试矩阵与停止条件；独立 Review 无阻塞项 | 评估稿 #633 | 待阶段 4/5 人审 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用：docs/superpowers/specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md（本分支）
|
||||
- 实施计划引用：docs/superpowers/plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md（I1–I3 零付费、P1 付费另批；R1）
|
||||
- 测试计划引用：同上计划 §2 测试矩阵、§3 Backend 用例（R1）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 待定 | 待执行 | — | — | — |
|
||||
| 需求评估 | 待定 | 待执行 | — | — | — |
|
||||
| 需求表确认 | 待定 | 待执行 | — | — | — |
|
||||
| 方案设计 | 5a7a0da | 待阶段 4 人审 | host 撰写 | 2026-10-19 | 用户选定 O2 |
|
||||
| 实施计划 | 5a7a0da | 待阶段 5 人审 | host 撰写 | 2026-10-19 | 同上 |
|
||||
| 实施与自检 | 待定 | 待执行 | — | — | — |
|
||||
| 正式测试与验收 | 待定 | 待执行 | — | — | — |
|
||||
| 代码 Review | 待定 | 待执行 | — | — | — |
|
||||
| 合入 | 待定 | 待执行 | — | — | — |
|
||||
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 2b7fdc39a1f44163f4766701429d61ffd6926f1a | 2b7fdc39a1f44163f4766701429d61ffd6926f1a | 2026-10-19T16:17:05Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态：未入队；调度记录：无
|
||||
- entry_id：无；attempt_id：无；窗口执行者：无
|
||||
- 固定候选：无（base/head、组件与相关配置引用实际尝试）
|
||||
- 调度依据：policy/delivery.md#合入调度
|
||||
- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果：O2 阶段 4 方案与阶段 5 计划完成并经独立 Review（PASS-with-fixes，已闭合）；本轮交付终点为文档合入 main，**待阶段 4/5 人审**。
|
||||
- 验证：文档类变更；独立 Review PASS-with-fixes；PR CI（GATE）见合入记录；产品测试 NOT_RUN（无代码）。
|
||||
- 影响与剩余项：仅文档与任务卡。剩余：阶段 4/5 人审；通过后另起 I1（Agent-Native）→ I2（Backend）→ I3（Dev 改钉）；P1 付费另提资源方案。
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余：待核对（依据实际成果更新适用方案/规划）
|
||||
- 首选下一任务：O2 I1 Agent-Native `route_contract_eof`（阶段 4/5 人审通过后）
|
||||
- 推荐依据：待填写
|
||||
- 前置条件/待确认：待核对
|
||||
- 预期产物/验收条件：待定义
|
||||
- 重复任务核对：待核对（已有/在途任务、PR 与规划记录）
|
||||
- 启动授权：未授权（须阶段 4/5 人审通过）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：独立 Review（Cursor Task 子代理 code-reviewer，fresh_session=true，session=fdb9367a-08bb-4e87-ae9d-ac8608290886；只接收需求、base 2b7fdc3/head 5a7a0da 与两份文档，未转交实施会话）；结论 PASS-with-fixes，0 阻塞、8 非阻塞（截断用例、C4/C6 定义、重定向与基址规范化、schema 语义整体迁移、拒绝事件逐字段一致、系统层扁平键与 5 个调用点、哨兵扫描、前提①风险引用），已在后续提交全部闭合。
|
||||
- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测）
|
||||
- CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果）
|
||||
- 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验）
|
||||
- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T16:16:15.823972+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "2b7fdc39a1f44163f4766701429d61ffd6926f1a",
|
||||
"after_head": "2b7fdc39a1f44163f4766701429d61ffd6926f1a",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "2b7fdc39a1f44163f4766701429d61ffd6926f1a",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=2b7fdc39a1",
|
||||
"[remote] origin/main=2b7fdc39a1 ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=0",
|
||||
"[worktrees] linked=5",
|
||||
"[recycle] merged un-recycled branches: feature/layered-python-env",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] 2b7fdc39a1（完整：2b7fdc39a1f44163f4766701429d61ffd6926f1a）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "3a96e0c9643e0dc8fb45bb9ca5dfa9e57c34d0ff3c11a46864d4d6df5116c012",
|
||||
"receipt_sha256": "242b51c81c4c825292cfacbdf27b212b74ed684dea9484aa239b1d83139449b2",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/242b51c81c4c825292cfacbdf27b212b74ed684dea9484aa239b1d83139449b2.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（合入前折叠）
|
||||
|
||||
- 本卡在 PR #639（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/639）合入前闭合并归档，随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填，也无需单独的闭合 PR。
|
||||
@@ -0,0 +1,612 @@
|
||||
# feature/iam-role-permission-linked-capabilities-perm-ux 任务卡
|
||||
|
||||
任务主记录：PR #629 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/629；状态：已完成（合入前闭合）；owner：weichen
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux（worktree）；分支：feature/iam-role-permission-linked-capabilities-perm-ux
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：90317d02a746ea3cd25021561ef40e8cd7498963；parent_pr：无；parent_source：origin
|
||||
- 需求分流：verdict=JOIN；selected_initiative=feature/iam-role-permission-linked-capabilities；requirement_sha256=6eab4bfaa1bb158cd0943427d00264a74059b77b967530dc7d7c32f2f9ada0fa；triage_receipt=/tmp/iam-perm-ux-triage.json；receipt_sha256=3dd33a2bd1a128579bd405339b682acbcd4f96c7b980ebb0941cd5c622ccebb7
|
||||
|
||||
- 授权与交付终点：按源码外方案 `/tmp/iam-permission-ux-plan-20261019-1dehpj7l/plan.md`（2026-10-19 评审稿，review.md 三项审阅 clean）实施 U1–U6：Backend 权限展示目录与关联预览合同、原子批量写入与读投影；Frontend 分类角色矩阵与单角色聚焦、用户/角色人员配置、项目有效权限说明；真实浏览器验收与组合交付。终点：子任务 PR 合入所属 L1 分支 `feature/iam-role-permission-linked-capabilities`（PR #628），组件 pin 随本任务推进；不部署、不迁移生产数据、不做日常实例采用（C16 保持 NOT_RUN 直至另行授权）。
|
||||
- 组件分支策略：Backend 工作分支 `feature/iam-perm-ux-backend`（基于 L1 U1 联动分支 `origin/feature/iam-link-u1-capability-association` @ afb65c5，消费其冻结的 `ProjectCreateLinkedActions`/`LinkedCapabilities` 合同）；Frontend 工作分支基于组件 origin/main（6db528d，L1 前端单元尚未启动）。
|
||||
- 依赖协调：#628 L1 的 U1（联动 Backend）已完成并推送（afb65c5）；L1 U2（单一角色权威）已登记待启动——其 `perms_api.go`/`hostcaps.go` 与本任务 `roles.go`/`role_policy.go` 不同区段，组合冲突由 L1 集成时解决；本任务不重写 L1 已实现的联动规则，只消费。
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**（方案 R1–R17，用户验收 C01–C16）：管理员无需理解技术权限字段即可看懂角色能做什么；默认业务分类矩阵可同时比较并编辑多个角色（三态控件：不允许/按项目授权/默认允许；系统动作仅允许/不允许）；单角色聚焦复用同一草稿；统一预览与原子保存；用户列表显示当前角色并支持单人/多人批量角色分配（服务端目录选择器，不手输账号）；复制角色并分配；系统自动处理创建项目联动并解释生效范围；项目有效权限说明。
|
||||
|
||||
**非目标**：多职位叠加、个人普通权限覆盖、通用权限引擎、审批系统、Excel 导入导出、批量系统管理授权、全库动态匹配选择；账号恢复/凭据管理（原入口）；超级管理员保护（#627）；成员共享读取语义（L1 U7）；生产部署与日常实例采用。
|
||||
|
||||
## 实施单元（本任务）
|
||||
|
||||
| 单元 | 范围 | 依赖 |
|
||||
|---|---|---|
|
||||
| permux-U1 权限展示与关联预览 | Backend `internal/authz/catalog/`、`internal/server/roles.go`、`internal/store/role_policy.go`、`pkg/extension/role_policy.go`：中文分类目录元数据、三态归一化、变更预览（含 #628 关联差异）、缺失/显式拒绝可区分 | L1 U1 合同（已冻结并实现 @ afb65c5） |
|
||||
| permux-U2 原子批量写入与读投影 | Backend 同上 + `internal/server/account_search.go`：多角色 patch 事务、多用户角色分配事务、复制角色并分配事务；用户目录当前角色投影、角色成员目录 | permux-U1 |
|
||||
| permux-U3 分类矩阵与单角色聚焦 | Frontend `RolePermissionsPanel.tsx`、`rolePermissions.ts`、`api.ts`、样式与测试 | permux-U1/U2 |
|
||||
| permux-U4 用户与角色人员配置 | Frontend `AccountUsersPanel.tsx`、`AdminZone.tsx`、`api.ts`、人员选择器与测试 | permux-U2；与 #627 AccountUsersPanel 修改按顺序合并（#627 未动本分支时直接实施） |
|
||||
| permux-U5 项目有效权限说明 | Frontend `adminRdmSections.tsx` 权限解释区；消费 L1 合同，L1 U3/U7 未组合前显式「联动服务未就绪」，不 mock | permux-U3/U4 + L1 真实规则 |
|
||||
| permux-U6 真实浏览器验收与交付 | `e2e/iam-role-authority.playwright.ts` 扩充、组合 gitlink、Review/CI/合入（host 主导） | 全部 |
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 验收 | 结论 |
|
||||
|---|---|---|---|
|
||||
| R1–R7 | 角色配置：分类矩阵、三态控件、联动预览、中文文案（方案 Requirements — Role Configuration） | C01–C06, C11, C14 | 纳入 permux-U1/U3 |
|
||||
| R8–R12 | 人员配置：目录检索、多选批量、复制分配、稳定 userId（方案 Requirements — User Configuration） | C07–C10, C14 | 纳入 permux-U2/U4 |
|
||||
| R13–R17 | 可靠性与验收：原子事务、幂等、固定选择集、可访问性、真实验收（方案 Reliability and Acceptance） | C09, C12, C14, C15 | 纳入 permux-U2/U6 |
|
||||
| C16 | 日常实例采用 | 运行版本核对 | NOT_RUN（未授权部署），单列记录 |
|
||||
|
||||
## 风险与决策记录
|
||||
|
||||
- L1 U2（单一角色权威）与本任务均在途：本任务 Backend 基于联动分支 afb65c5，L1 后续单元合入时由 L1 集成解决；两单元文件区段不重叠（其 perms_api/hostcaps，本任务 roles/role_policy/account_search）。
|
||||
- 「创建项目→自动关联」运行时联动已在 L1 U1 实现（afb65c5）；本任务 U1 的预览/展示直接消费 `catalog.ProjectCreateLinkedActions()` 与 `LinkedCapabilities`，不另建第二套关联规则。
|
||||
- L1 U7（成员共享读取）未实现：permux-U5 相关展示显式标注联动服务未就绪，不伪造；验收 C13 由 L1 U7 交付时闭环。
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| permux-U1 | catalog 分类元数据 + PreviewRolePermissions + POST /api/admin/roles/permissions/preview | 76bc59db1d0e9127（AGENT-EXECUTION digest） | implementation | cursor→agy→pi | 1 | cursor（session 204c93fb…） | success（transport 未应用：host 以相对路径调用 run，收据 repo 字段与 apply 校验不兼容；保留现场） | refs/agent-exec/8ac83883…/a433eb6f（未应用） | never | /tmp/permux-u1-run.json |
|
||||
| permux-U1 | 同上（全新会话重跑，调用形式 --repo .） | 76bc59db1d0e9127 | implementation | cursor→agy→pi | 1 | cursor（新 session，event 未报则 not-observable） | success | 已应用 bc09721（fast-forward afb65c5→bc09721） | never | /tmp/permux-u1-run2.json |
|
||||
| permux-U2 | 批量 patch/批量分配/复制分配事务 + 目录角色投影 + 角色成员目录 | 76bc59db1d0e9127 | implementation | cursor→agy→pi | 1 | cursor（session 未在事件中报告：not-observable） | success | 已应用 6851ee6（fast-forward bc09721→6851ee6） | never | /tmp/permux-u2-run.json |
|
||||
| permux-U3 | 分类矩阵默认视图 + 三态/二态控件 + 多角色草稿统一预览与原子保存 + 窄屏聚焦 | 76bc59db1d0e9127 | implementation | cursor→agy→pi | 1 | cursor（session not-observable） | success | 已应用 4be7362（fast-forward 6db528d→4be7362，Frontend 分支 feature/iam-perm-ux-frontend） | never | /tmp/permux-u3-run.json |
|
||||
| permux-U4 | 用户表当前角色/多选/批量分配 + 复制角色并分配 + 角色成员子视图 | 76bc59db1d0e9127 | implementation | cursor→agy→pi | 1 | cursor（session not-observable） | success | 已应用 d965732（fast-forward 4be7362→d965732） | never | /tmp/permux-u4-run.json |
|
||||
| permux-U5 | me.linkedCapabilities 消费 + 职责条件/来源文案 + 创建关联说明卡（creator/共享读取留待 L1 U2/U7，未 mock） | 76bc59db1d0e9127 | implementation | cursor→agy→pi | 1 | cursor（session not-observable） | success | 已应用 a6ce695（fast-forward d965732→a6ce695） | never | /tmp/permux-u5-run.json |
|
||||
| permux-U6 组合 pin | backend@6851ee6 + frontend@a6ce695 → Dev 子分支 | 76bc59db1d0e9127 | implementation | cursor→agy→pi | 1 | cursor（session not-observable） | success | 已应用 7b25169（Dev 子分支 transport） | never | /tmp/permux-u6-pins-run.json |
|
||||
| permux-U6 knip repair | 去除 3 个未消费导出的 export（frontend） | 76bc59db1d0e9127 | repair | cursor→agy→pi | 1 | cursor（session not-observable） | success | 已应用 1d907c1（frontend a6ce695→1d907c1） | never | /tmp/permux-knip-run.json |
|
||||
| permux-U6 live spec | e2e/iam-perm-ux-live.playwright.ts 新增（真实服务 8 场景） | 76bc59db1d0e9127 | implementation | cursor→agy→pi | 1 | cursor（session not-observable） | success | 已应用 7d9ac7c | never | /tmp/permux-u6-e2e-run.json |
|
||||
| permux-U6 live 字段修复 | linkedActions 字段名修正 | 76bc59db1d0e9127 | repair | cursor→agy→pi | 1 | cursor（session not-observable） | success | 已应用 c37c33b | never | /tmp/permux-e2e-fix2-run.json |
|
||||
| permux-U6 live 字段修复（首次） | 同上 | 76bc59db1d0e9127 | repair | cursor→agy→pi | 1 | cursor | failed-unknown（worker 未输出有效终态记录；fail-stop，现场保留未应用） | 未应用 | never | /tmp/permux-e2e-fix-run.json |
|
||||
| permux-U6 预览 patch 模式 | PreviewRolePermissions 增加 mode=patch 与批量提交同源归并（Backend 4130ad7） | 76bc59db1d0e9127 | repair | cursor→agy→pi | 1 | cursor（session not-observable） | success | 已应用 4130ad7（backend 6851ee6→4130ad7） | never | /tmp/permux-preview-fix-run.json |
|
||||
| permux-U6 前端预览模式×2 | 预览请求带 mode 及层级修正（c37c33b→054f134→128aafed） | 76bc59db1d0e9127 | repair | cursor→agy→pi | 各 1 | cursor | success×2 | 已应用 054f134、128aafed | never | /tmp/permux-fe-mode-run.json、/tmp/permux-mode-level-run.json |
|
||||
| permux-U6 复制表单崩溃修复 | 角色投影无 permissions 时详情崩溃（真实组合发现）修复（46a63f02） | 76bc59db1d0e9127 | repair | cursor→agy→pi | 1 | cursor（session not-observable） | success | 已应用 46a63f02 | never | /tmp/permux-copy-fix-run.json |
|
||||
| permux-U6 组合 pin×2 | 终态组合 backend@4130ad7 + frontend@46a63f02 → bdd058f | 76bc59db1d0e9127 | implementation | cursor→agy→pi | 各 1 | cursor | success×2 | 已应用 650944a、bdd058f | never | /tmp/permux-u6-pins2-run.json、/tmp/permux-u6-pins3-run.json |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed | 90317d02a746ea3cd25021561ef40e8cd7498963 | 2026-10-19T03:13:11Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果：U1–U5 全部实现并通过独立单元验证；U6 组合交付完成（Dev 子分支 bdd058f：backend@4130ad7 + frontend@46a63f02）。真实浏览器活体验收 8/8 PASS（登录、C01+C02 多角色矩阵编辑与一次原子提交、C03 创建联动补齐与 /api/me 运行时联动、C04 断链拒绝与恢复、C07 同名辨识、C08 两人预览后一次分配、C09 409 整批不写且保留选择、C10 复制并分配原子成功）。
|
||||
- 验证：
|
||||
- PASS：C01–C04、C07–C10（真实服务，evidence /tmp/permux-final-live.json）；`make test-affected`（test-worktree/boundaries/pins/backend/frontend，evidence /tmp/permux-final-affected.json）；后端 store/server 过滤套件含批量/复制/预览负控；前端 vitest 601 项 + design-guard + knip（50≤51）+ tsc；build 通过。
|
||||
- NOT_RUN（如实声明）：C05/C11/C12 的部分负控由 HTTP/store 测试覆盖、未在浏览器层重复；C06 浏览器层关闭未来创建场景未单列（store 层 kept/migrationNote 已测）；C13 成员共享读取与 creator 来源解释——依赖 L1 U7/U2，未 mock；C14 完整键盘/读屏人工走查未执行（可访问性由实现约定+design-guard+窄屏 helper 测试覆盖）；C15 幂等/超额负控在 store 测试覆盖、未在浏览器重复；C16 日常实例采用未执行（未授权部署）。
|
||||
- 环境事实：本机 umask 0077 使 pkg/identity TestDSNFileMode 必然失败，umask 0022 下通过（identity 包本任务未改动）。
|
||||
- 真实组合发现的缺陷与修复：预览 replace 语义与批量 patch 语义错配（补齐 mode=patch 与前端适配）；用户详情复制表单对无 permissions 投影崩溃（前端修复）。
|
||||
- 影响与剩余项：L1 合入后，C13/C16 与全量 C 项回归由 L1 U5/U7 及后续集成任务承接；#627 落地后批量路径应消费其目标保护；review/CI/合入记录见下节。
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：PASS（0 阻塞，5 项非阻塞建议）。审阅者：全新 CLI 独立会话（pi / MiniMax-M3，未参与实现，fresh_session=true，session not-observable）；对象：Dev 90317d02..234ce30 + 组件 origin/main…feature/iam-perm-ux-backend@4130ad7、feature/iam-perm-ux-frontend@46a63f02；报告全文 .task/reviews/2026-10-19-permux-independent-review.md（随本分支合入）；收据 /tmp/permux-review2-run.json（首次只读会话因无文件产物记 failed-unknown，见 /tmp/permux-review-run.json）。非阻塞建议（后续增量，不随本 PR 修）：批量角色行锁未按 roleID 排序（PG 高并发瞬时回滚）；目录接口返回完整 profile 可裁剪；roleDraftLeaveGuard 复位间隙；catalog 失败回填的编辑闪烁；adoptRoleSnapshot 注释明示。
|
||||
- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测）
|
||||
- CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果）
|
||||
- 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验）
|
||||
- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T03:12:24.090626+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"after_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=7716b28cff",
|
||||
"[remote] origin/main=7716b28cff ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=13",
|
||||
"[warn] 13 个子模块未初始化——构建/测试前需物化（不阻断写入）",
|
||||
"[worktrees] linked=5",
|
||||
"[recycle] merged un-recycled branches: feature/layered-python-env",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] 7716b28cff（完整：7716b28cfff5200e7cfe9ec75aff5bcd71b234ed）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "07bfa89f466fec4670149743fcc24eec9e572add7603cbc9a08b6c6268f511b3",
|
||||
"receipt_sha256": "82a56765b5b0630ed103d995875cdeb55426259336a503bb7d1a8bbf42aa9a40",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/82a56765b5b0630ed103d995875cdeb55426259336a503bb7d1a8bbf42aa9a40.json"
|
||||
}
|
||||
```
|
||||
| 同步（记录前对象） | a99dbfcd9ac48d09038c76e09dc59e074c11ab7d | 04af865e227858bbe9f0bd38ebaed2b874da4f27 | 2026-10-19T03:18:24Z |
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T03:39:09.339573+00:00",
|
||||
"command": "sh -c 'cd modules/backend && GOWORK=off go build ./... && GOWORK=off go test ./internal/authz/... ./internal/store ./internal/server -run \"Role|Policy|Binding|AccountSearch|Preview|Catalog\" -count=1 && GOWORK=off go vet ./internal/authz/catalog ./internal/store ./internal/server && git status --porcelain -- deps/ | wc -l'",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "c17b0ae76ccf0d37060bed5a822d48b12b1da432",
|
||||
"after_head": "c17b0ae76ccf0d37060bed5a822d48b12b1da432",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "9d0b0e5082d3f2737db82c268a6c72f3c9826a418ce20c834042587f36f0a258",
|
||||
"after_tracked_diff_sha256": "9d0b0e5082d3f2737db82c268a6c72f3c9826a418ce20c834042587f36f0a258",
|
||||
"output_tail": [
|
||||
"? \tagent-system-backend/internal/authz\t[no test files]",
|
||||
"ok \tagent-system-backend/internal/authz/catalog\t0.008s",
|
||||
"ok \tagent-system-backend/internal/store\t0.665s",
|
||||
"ok \tagent-system-backend/internal/server\t1.834s",
|
||||
"0"
|
||||
],
|
||||
"output_sha256": "738432121e1862d4b5466f789033634bca2025c29e89c8bd444dbbdba59d6f94",
|
||||
"receipt_sha256": "db537adfa357d41e0f84f7aba19fd5fe85f3249cdbfe92887e675be4a73c966a",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/db537adfa357d41e0f84f7aba19fd5fe85f3249cdbfe92887e675be4a73c966a.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T03:53:20.691306+00:00",
|
||||
"command": "sh -c 'cd modules/backend && GOWORK=off go build ./... && GOWORK=off go test ./internal/authz/... ./internal/store ./internal/server -run \"Role|Policy|Binding|AccountSearch|Batch|CopyAssign|Members|Preview|Catalog\" -count=1 && GOWORK=off go vet ./internal/store ./internal/server && git status --porcelain -- deps/ | wc -l'",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "cfe90a8742263c32d67f91614f8b5d8a6e4b3f28",
|
||||
"after_head": "cfe90a8742263c32d67f91614f8b5d8a6e4b3f28",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "01694e3df50336ad8bdf88e7519628925d66e7bed13e94745ee5d78af591fa12",
|
||||
"after_tracked_diff_sha256": "01694e3df50336ad8bdf88e7519628925d66e7bed13e94745ee5d78af591fa12",
|
||||
"output_tail": [
|
||||
"? \tagent-system-backend/internal/authz\t[no test files]",
|
||||
"ok \tagent-system-backend/internal/authz/catalog\t0.002s",
|
||||
"ok \tagent-system-backend/internal/store\t0.818s",
|
||||
"ok \tagent-system-backend/internal/server\t2.648s",
|
||||
"0"
|
||||
],
|
||||
"output_sha256": "bc4b28c38cb498d35ef2e3d2d5b296654b08779a71dafc8073670d42cda11de6",
|
||||
"receipt_sha256": "be276a366de77bd675a1dfccf23023b269633940a712195042d949138c765c55",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/be276a366de77bd675a1dfccf23023b269633940a712195042d949138c765c55.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T04:05:14.627845+00:00",
|
||||
"command": "sh -c 'cd modules/frontend && npx vitest run test/role-permissions.test.ts test/role-permissions-ui.test.ts test/design-guard.test.ts 2>&1 | tail -4 && npx tsc -b && echo TSC_OK'",
|
||||
"exit_code": 1,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "fa8b5fb1c147d7660ef219dfa53be73a9a064f79",
|
||||
"after_head": "fa8b5fb1c147d7660ef219dfa53be73a9a064f79",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "5a432adeeb888e4790fabbdc35121353f79ebf5eaed38a65520da364553468df",
|
||||
"after_tracked_diff_sha256": "5a432adeeb888e4790fabbdc35121353f79ebf5eaed38a65520da364553468df",
|
||||
"output_tail": [
|
||||
" Tests 26 passed (26)",
|
||||
" Start at 04:05:15",
|
||||
" Duration 456ms (transform 369ms, setup 0ms, import 460ms, tests 22ms, environment 0ms)",
|
||||
"",
|
||||
"../ui/src/activitySummary.ts(2,49): error TS2307: Cannot find module 'marked' or its corresponding type declarations.",
|
||||
"../ui/src/safeHtml.tsx(4,24): error TS2307: Cannot find module 'marked' or its corresponding type declarations.",
|
||||
"../ui/src/safeHtml.tsx(5,29): error TS2307: Cannot find module 'dompurify' or its corresponding type declarations.",
|
||||
"../ui/src/safeHtml.tsx(6,29): error TS2307: Cannot find module 'dompurify' or its corresponding type declarations.",
|
||||
"../ui/src/safeHtml.tsx(54,46): error TS7006: Parameter 'node' implicitly has an 'any' type.",
|
||||
"../ui/src/safeHtml.tsx(54,52): error TS7006: Parameter 'data' implicitly has an 'any' type.",
|
||||
"../ui/src/safeHtml.tsx(56,53): error TS7006: Parameter 'name' implicitly has an 'any' type.",
|
||||
"../ui/src/safeHtml.tsx(61,47): error TS7006: Parameter 'node' implicitly has an 'any' type."
|
||||
],
|
||||
"output_sha256": "62f6c2f955af2580587185359c855db2cd2c9b708ff4f214e7daf1c6af7cbca3",
|
||||
"receipt_sha256": "2b0c8fd7d7c6f4e2b2d686a99cc4de0c9ac33bf0e529dc097869bfea2b1e2698",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/2b0c8fd7d7c6f4e2b2d686a99cc4de0c9ac33bf0e529dc097869bfea2b1e2698.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T04:06:33.549745+00:00",
|
||||
"command": "sh -c 'cd modules/frontend && npx vitest run test/role-permissions.test.ts test/role-permissions-ui.test.ts test/design-guard.test.ts 2>&1 | tail -4 && npx tsc -b && echo TSC_OK'",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "fa8b5fb1c147d7660ef219dfa53be73a9a064f79",
|
||||
"after_head": "fa8b5fb1c147d7660ef219dfa53be73a9a064f79",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "1a6610bf25c8514e73982e4c2ec2afa122deba4db666670b3c26e69b8b201999",
|
||||
"after_tracked_diff_sha256": "1a6610bf25c8514e73982e4c2ec2afa122deba4db666670b3c26e69b8b201999",
|
||||
"output_tail": [
|
||||
" Tests 26 passed (26)",
|
||||
" Start at 04:06:33",
|
||||
" Duration 351ms (transform 281ms, setup 0ms, import 354ms, tests 20ms, environment 0ms)",
|
||||
"",
|
||||
"TSC_OK"
|
||||
],
|
||||
"output_sha256": "9b4104496d0cfb6faa5fbb49ec4717eca4d7492de6963a767a631c73afdaf641",
|
||||
"receipt_sha256": "35f7e24a7106e9b04e96f1ad05ceecdc75062af14156135314ff45bbc4f19494",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/35f7e24a7106e9b04e96f1ad05ceecdc75062af14156135314ff45bbc4f19494.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T04:17:53.352830+00:00",
|
||||
"command": "sh -c 'cd modules/frontend && npx vitest run test/account-users-panel.test.ts test/role-members.test.ts test/role-permissions.test.ts test/role-permissions-ui.test.ts test/design-guard.test.ts 2>&1 | tail -4 && npx tsc -b && echo TSC_OK'",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "b1a1ffbda55bd219c849cb69336f07e690e57342",
|
||||
"after_head": "b1a1ffbda55bd219c849cb69336f07e690e57342",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "ed490c9560a136815bf04b76235761a1104d3c5fe43754b7505a7498be12044b",
|
||||
"after_tracked_diff_sha256": "ed490c9560a136815bf04b76235761a1104d3c5fe43754b7505a7498be12044b",
|
||||
"output_tail": [
|
||||
" Tests 43 passed (43)",
|
||||
" Start at 04:17:53",
|
||||
" Duration 368ms (transform 655ms, setup 0ms, import 816ms, tests 30ms, environment 0ms)",
|
||||
"",
|
||||
"TSC_OK"
|
||||
],
|
||||
"output_sha256": "8650d93bb8fb8f383cb9cdaff1de0bd7a8cd84045863cbcda89bc97ef9a791b9",
|
||||
"receipt_sha256": "ff22fc2ac93c050ca1c1e48f9e8d02d6b70acfb91c4ec43aa7eb7bb6d676c29d",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/ff22fc2ac93c050ca1c1e48f9e8d02d6b70acfb91c4ec43aa7eb7bb6d676c29d.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T04:22:52.740525+00:00",
|
||||
"command": "sh -c 'cd modules/frontend && npx vitest run test/permission-explanations.test.ts test/role-members.test.ts test/design-guard.test.ts 2>&1 | tail -4 && npx tsc -b && echo TSC_OK'",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "9a9c9699707a64fd3c42cafca43b852c0e2360ef",
|
||||
"after_head": "9a9c9699707a64fd3c42cafca43b852c0e2360ef",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "72c8f8764864ab3a21ecfa3b718b5b4f6af0558bf2a78da32cb2ecaa944f3038",
|
||||
"after_tracked_diff_sha256": "72c8f8764864ab3a21ecfa3b718b5b4f6af0558bf2a78da32cb2ecaa944f3038",
|
||||
"output_tail": [
|
||||
" Tests 28 passed (28)",
|
||||
" Start at 04:22:53",
|
||||
" Duration 129ms (transform 70ms, setup 0ms, import 98ms, tests 24ms, environment 0ms)",
|
||||
"",
|
||||
"TSC_OK"
|
||||
],
|
||||
"output_sha256": "61d36b9c51a038a5d0412bdc14ab3fecc312a6f161de6c4a56700f0a594058ef",
|
||||
"receipt_sha256": "4841be620f46292654dbd43bc0f132ca4118792756394f14b1b6892a7f866507",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/4841be620f46292654dbd43bc0f132ca4118792756394f14b1b6892a7f866507.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T04:27:22.417342+00:00",
|
||||
"command": "sh -c 'umask 0022 && make test-affected 2>&1 | tail -8'",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "7b25169fad83291ff342213afeb20ca2fa2efed8",
|
||||
"after_head": "7b25169fad83291ff342213afeb20ca2fa2efed8",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
" Start at 04:27:54",
|
||||
" Duration 814ms (transform 6.92s, setup 0ms, import 11.46s, tests 960ms, environment 4ms)",
|
||||
"",
|
||||
"knip unused exports 53 exceed baseline 51",
|
||||
"make[2]: *** [Makefile:188: test-frontend] Error 1",
|
||||
"make[2]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'",
|
||||
"make[1]: *** [Makefile:221: test-affected] Error 2",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'"
|
||||
],
|
||||
"output_sha256": "c5041e844c8690957d62bcc1f7eb0c14c390a0fadb3953577d3266c39a149c39",
|
||||
"receipt_sha256": "2227942e89094d6d44dca758185d4d836f83a790610d381c9d2e596f5253ac8d",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/2227942e89094d6d44dca758185d4d836f83a790610d381c9d2e596f5253ac8d.json"
|
||||
}
|
||||
```
|
||||
|
||||
## U6 组合与验证记录
|
||||
|
||||
- 组合 transport：7b25169（backend→6851ee6，frontend→a6ce695）；knip 修复后 frontend 分支推进至 1d907c1（repair 收据 /tmp/permux-knip-run.json，cursor 一次成功），组合 pin 二次推进见后续记录。
|
||||
- 环境事实：本机 umask 0077 使 pkg/identity TestDSNFileMode（0o644 拒绝用例）必然失败；umask 0022 下通过。该失败为环境因素，非本任务回归（identity 包本任务未触及）。
|
||||
- 缺陷收据说明：/tmp/permux-u6-affected.json 因 host 在 CMD 中使用 `| tail` 吞掉管道退出码而记录 exit=0，但输出含 test-frontend knip 超基线失败——该收据不作为 PASS 证据；超额已由 knip repair 修复（50 ≤ 51），test-affected 将以无管道方式重新捕获。
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T04:38:56.269044+00:00",
|
||||
"command": "sh -c 'umask 0022 && make test-affected'",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "650944ae6897ca0d1ea76875fe8015c3364b5d71",
|
||||
"after_head": "650944ae6897ca0d1ea76875fe8015c3364b5d71",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"(node:240613) ExperimentalWarning: localStorage is not available because --localstorage-file was not provided.",
|
||||
"(Use `node --trace-warnings ...` to show where the warning was created)",
|
||||
"(node:240680) ExperimentalWarning: localStorage is not available because --localstorage-file was not provided.",
|
||||
"(Use `node --trace-warnings ...` to show where the warning was created)",
|
||||
"(node:240614) ExperimentalWarning: localStorage is not available because --localstorage-file was not provided.",
|
||||
"(Use `node --trace-warnings ...` to show where the warning was created)",
|
||||
"",
|
||||
" Test Files 50 passed (50)",
|
||||
" Tests 601 passed (601)",
|
||||
" Start at 04:39:03",
|
||||
" Duration 836ms (transform 7.74s, setup 0ms, import 11.93s, tests 941ms, environment 4ms)",
|
||||
"",
|
||||
"knip unused exports 50 <= 51",
|
||||
"make[2]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'"
|
||||
],
|
||||
"output_sha256": "48eaf015c3e561bd34008b771d984d9e267062fd2cf810d67a2aaec05793e80d",
|
||||
"receipt_sha256": "59fb000313feb6ed03a2b1d2305a9372a6a991b218c95449a93a353b1d5dcc69",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/59fb000313feb6ed03a2b1d2305a9372a6a991b218c95449a93a353b1d5dcc69.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T05:35:26.812094+00:00",
|
||||
"command": "sh -c 'umask 0022 && make test-affected'",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "bdd058f974cb1e681b253230e6acbd75674eaa84",
|
||||
"after_head": "bdd058f974cb1e681b253230e6acbd75674eaa84",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "97f08e41dec9f0a379f5c3010d58388160715650ce758c4d000560fdfd1d7e63",
|
||||
"after_tracked_diff_sha256": "97f08e41dec9f0a379f5c3010d58388160715650ce758c4d000560fdfd1d7e63",
|
||||
"output_tail": [
|
||||
"(node:1933409) ExperimentalWarning: localStorage is not available because --localstorage-file was not provided.",
|
||||
"(Use `node --trace-warnings ...` to show where the warning was created)",
|
||||
"(node:1933535) ExperimentalWarning: localStorage is not available because --localstorage-file was not provided.",
|
||||
"(Use `node --trace-warnings ...` to show where the warning was created)",
|
||||
"(node:1933410) ExperimentalWarning: localStorage is not available because --localstorage-file was not provided.",
|
||||
"(Use `node --trace-warnings ...` to show where the warning was created)",
|
||||
"",
|
||||
" Test Files 50 passed (50)",
|
||||
" Tests 602 passed (602)",
|
||||
" Start at 05:36:03",
|
||||
" Duration 958ms (transform 8.76s, setup 0ms, import 14.30s, tests 1.02s, environment 4ms)",
|
||||
"",
|
||||
"knip unused exports 51 <= 51",
|
||||
"make[2]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'"
|
||||
],
|
||||
"output_sha256": "18a8e221f7bb03ca79c568af4e3304be9bbc308a4c53230e22db9569df152ec4",
|
||||
"receipt_sha256": "af3688b164357d007bf5aa7dbc06890b7e13e2842779acb3c3cd86ee77f03c55",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/af3688b164357d007bf5aa7dbc06890b7e13e2842779acb3c3cd86ee77f03c55.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T05:36:11.940198+00:00",
|
||||
"command": "sh -c 'cd modules/frontend && PLAYWRIGHT_BASE_URL=http://127.0.0.1:4199 PERMUX_LIVE=1 PERMUX_OWNER=permuxadmin PERMUX_PASSWORD=<redacted> npx playwright test e2e/iam-perm-ux-live.playwright.ts'",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "bdd058f974cb1e681b253230e6acbd75674eaa84",
|
||||
"after_head": "bdd058f974cb1e681b253230e6acbd75674eaa84",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "33ee1abfd7b5c632cfb27c3b22c7b1c239e8320854108e926a7ada43a8dd3e37",
|
||||
"after_tracked_diff_sha256": "33ee1abfd7b5c632cfb27c3b22c7b1c239e8320854108e926a7ada43a8dd3e37",
|
||||
"output_tail": [
|
||||
"",
|
||||
"Running 8 tests using 1 worker",
|
||||
"",
|
||||
" ✓ 1 e2e/iam-perm-ux-live.playwright.ts:145:3 › permux 活体主流程（真实 Backend + 真实 Frontend dist） › 登录：管理员经登录表单进入工作台，/api/me 为管理员 (283ms)",
|
||||
" ✓ 2 e2e/iam-perm-ux-live.playwright.ts:172:3 › permux 活体主流程（真实 Backend + 真实 Frontend dist） › C01+C02 多角色矩阵编辑：跨分类与搜索保留草稿，预览后一次提交 (2.8s)",
|
||||
" ✓ 3 e2e/iam-perm-ux-live.playwright.ts:231:3 › permux 活体主流程（真实 Backend + 真实 Frontend dist） › C03 创建联动：开启创建项目自动补齐四项按项目授权，运行时 /api/me 联动生效 (573ms)",
|
||||
" ✓ 4 e2e/iam-perm-ux-live.playwright.ts:267:3 › permux 活体主流程（真实 Backend + 真实 Frontend dist） › C04 断链拒绝：创建项目开启时联动项不允许不可保存，恢复按项目授权后保存成功 (430ms)",
|
||||
" ✓ 5 e2e/iam-perm-ux-live.playwright.ts:305:3 › permux 活体主流程（真实 Backend + 真实 Frontend dist） › C07 同名辨识：两名同名用户按账号辨识，勾选互不串行 (1.1s)",
|
||||
" ✓ 6 e2e/iam-perm-ux-live.playwright.ts:333:3 › permux 活体主流程（真实 Backend + 真实 Frontend dist） › C08 批量分配：两人预览 未分配 → 角色乙 后一次提交 (593ms)",
|
||||
" ✓ 7 e2e/iam-perm-ux-live.playwright.ts:356:3 › permux 活体主流程（真实 Backend + 真实 Frontend dist） › C09 冲突整批不写：确认前他人改动一人角色，409 后整批未写入且保留选择 (730ms)",
|
||||
" ✓ 8 e2e/iam-perm-ux-live.playwright.ts:389:3 › permux 活体主流程（真实 Backend + 真实 Frontend dist） › C10 复制并分配：源角色权限复制到新角色并换绑，新角色独立维护 (295ms)",
|
||||
"",
|
||||
" 8 passed (7.4s)"
|
||||
],
|
||||
"output_sha256": "eaa754b30e6f134a8e55f19a417efc4c8cbc03c8eb72db9c56624d5700cecf44",
|
||||
"receipt_sha256": "c7da99a1f2734fdfcfd2ff0373287773d731001ca689f012ce6b039d70091cfa",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/c7da99a1f2734fdfcfd2ff0373287773d731001ca689f012ce6b039d70091cfa.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 交付阻塞记录（2026-10-19）
|
||||
|
||||
- 平台事实：Gitea `https://git-home.u1680832.nyat.app:30319` 当前 TLS 握手失败（WRONG_VERSION_NUMBER），明文 `http://…:30319/api/v1/version` 返回 501 代理错误页（非 Gitea JSON）；同日早些时候（03:05 分流）HTTPS API 正常。policy/facts.md F1 判据已失效，恢复后须 `make facts-verify` 重验。
|
||||
- git/SSH 通道正常：三个分支均已推送（Dev 子分支 f97790b、Backend feature/iam-perm-ux-backend @ 4130ad7、Frontend feature/iam-perm-ux-frontend @ 46a63f02）。
|
||||
- 受阻动作：PR 创建、`make task-pr-check`、CI 等待（`make ci-wait`）、独立 Review 提交与合入——均标 NOT_RUN/阻塞，待平台恢复后在同一收据流程下继续；不得以本地证据替代平台准入。
|
||||
- 现场保护：worktree 与全部组件分支保留；无未提交的实施代码（任务卡记录除外）。
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T07:12:01.645701+00:00",
|
||||
"command": "make task-pr-check PR=629",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "e7bcc61ba6ea378a24ab43643b81fa41d2076bd3",
|
||||
"after_head": "e7bcc61ba6ea378a24ab43643b81fa41d2076bd3",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "73bc9f208103ec1b9b83775ca65fee12f79ba99e",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "016330b58d3f18c8ee1ec97dafdae2bda81a4b8ca4503fc156bef1ce0a843a10",
|
||||
"after_tracked_diff_sha256": "016330b58d3f18c8ee1ec97dafdae2bda81a4b8ca4503fc156bef1ce0a843a10",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'",
|
||||
"python3 scripts/task_pr_check.py local --pr 629 ",
|
||||
"[verdict] PR_CHECK_OK base=feature/iam-role-permission-linked-capabilities head=e7bcc61ba6ea378a24ab43643b81fa41d2076bd3 kind=child",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'"
|
||||
],
|
||||
"output_sha256": "6d920e3b949ce2190266128b8fab6d643b9a43fde82ee3b09a50745e8503715f",
|
||||
"receipt_sha256": "9ac80ba53e969973c510fb8344215feb365a76693b83499130b5547fbb910264",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/9ac80ba53e969973c510fb8344215feb365a76693b83499130b5547fbb910264.json"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T07:32:01.073317+00:00",
|
||||
"command": "make ci-wait SHA=374ce2d3822ae6ae5514cab2d6b0701f8f88c049",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "374ce2d3822ae6ae5514cab2d6b0701f8f88c049",
|
||||
"after_head": "374ce2d3822ae6ae5514cab2d6b0701f8f88c049",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "73bc9f208103ec1b9b83775ca65fee12f79ba99e",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'",
|
||||
"python3 scripts/ci_wait.py --sha 374ce2d3822ae6ae5514cab2d6b0701f8f88c049 ",
|
||||
"[ci-wait] sha=374ce2d3822a ci / svc-realcombo (pull_request)=skipped ci / test (pull_request)=success ci / test-pg (pull_request)=skipped",
|
||||
"[verdict] CI_SUCCESS sha=374ce2d3822ae6ae5514cab2d6b0701f8f88c049",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'"
|
||||
],
|
||||
"output_sha256": "2909a1b5ce8c20fa15b10b1bcc1fe64c25cccfe1200350cb45420b2c410ffe2e",
|
||||
"receipt_sha256": "c62c86cfb7bdf8157ba804c7832cccc0424d0001be34f1cfec9f98f92680b6c5",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/c62c86cfb7bdf8157ba804c7832cccc0424d0001be34f1cfec9f98f92680b6c5.json"
|
||||
}
|
||||
```
|
||||
| 同步（记录前对象） | e1e0887e12501158e04477659d4567262dc44a73 | 2f88c756faaa267daf99d311415e7253fb5b4f23 | 2026-10-19T07:55:31Z |
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T07:54:30.575767+00:00",
|
||||
"command": "make task-sync",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux",
|
||||
"before_head": "e4aa6337502a5b317067f25b6b52033117cb20e3",
|
||||
"after_head": "c1cf9dd0ad6b1cd2a8f1ef668e288360e9777edc",
|
||||
"branch": "feature/iam-role-permission-linked-capabilities-perm-ux",
|
||||
"target_branch": "main",
|
||||
"target_head": "38ac2b0687514b480cc61dec425e1affb37c6295",
|
||||
"root_target": "main",
|
||||
"immediate_target": "feature/iam-role-permission-linked-capabilities",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"[worktree] materialize: recursive component checks passed",
|
||||
"[worktree] after-sync: recursive component checks passed",
|
||||
"admit: ok",
|
||||
"[evidence] WARN JSON receipt line 103: unverified: recorded component state was not at its pinned SHA ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 145: unverified: recorded object includes uncommitted non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 176: unverified: recorded object includes uncommitted non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 207: unverified: recorded object includes uncommitted non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 245: unverified: recorded object includes uncommitted non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 276: unverified: recorded object includes uncommitted non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 307: unverified: recorded object includes uncommitted non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 338: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[evidence] WARN JSON receipt line 378: recorded HEAD predates non-card changes ——关键检查须重跑并以 make evidence 重新写入",
|
||||
"[synced] sync_base=e1e0887e12501158e04477659d4567262dc44a73 tested_head=c1cf9dd0ad6b1cd2a8f1ef668e288360e9777edc checked_at=2026-10-19T07:55:32Z changed=1 sync_target=feature/iam-role-permission-linked-capabilities",
|
||||
"[next] 跑正式验收（make test 等），证据写入任务卡",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities-perm-ux'"
|
||||
],
|
||||
"output_sha256": "0de9daceeef02d1ac6f001ee3f3e88f40f00d2256ff08ba95c7d1ce0d6d0c4cb",
|
||||
"receipt_sha256": "46d8df5f1b56492e3155f9e785621b2fd9f86a346f10c0b6642cfe4281ca7ad2",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/46d8df5f1b56492e3155f9e785621b2fd9f86a346f10c0b6642cfe4281ca7ad2.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（合入前折叠）
|
||||
|
||||
- 本卡在 PR #629（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/629）合入前闭合并归档，随该 PR 一同合入。
|
||||
- 该 PR 的合并提交即本任务的落地记录。
|
||||
- 合入后无需回填，也无需单独的闭合 PR。
|
||||
+146
@@ -0,0 +1,146 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u1-capability-association 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：90317d02a746ea3cd25021561ef40e8cd7498963；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：在 `feature/iam-role-permission-linked-capabilities` 之上按方案 U1 修改 Backend 与 RDM 公开能力文件，实现业务能力联动（R3/R6/R16, KTD1/KTD3/KTD4），交付到 L1 initiative 分支；不开 PR、不入 main。
|
||||
- 当前实际交付：Backend L1 子分支 `feature/iam-link-u1-capability-association` @ `afb65c5678d8e17544f045ef7143866ffdc703e3` 已推送（Agent-System-Backend 远端）；RDM `role_provider.go` 迁移按方案依赖链留待 U2。
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段：需求拆解；当前增量：U1 capability-association
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：实现"创建能力开启即联动获得本人项目管理资格"的业务能力关联规则；服务端原子展开、保存校验、HTTP/command 同一服务端关联规则；显式冲突整笔拒绝；关闭创建能力不破坏已有项目。
|
||||
|
||||
**范围**：
|
||||
- Backend `internal/authz/catalog/catalog.go`：仅在必要时新增 `project.work` 等用于基础协作判定的描述项；不引入与方案 §"Capability Association Map" 不一致的描述。
|
||||
- Backend `internal/store/role_policy.go`：扩展 `ReplaceRolePermissions`、`ReplaceSystemGrants`、`ImportRoleAuthority`、`ActivateRoleAuthorityImport` 使其在同一事务内做"业务能力关联"校验；提供导出给 RDM/Backend Host 的联动投影。
|
||||
- Backend `internal/authz/service.go`：扩展 `AuthorizeSystem` 与必要新方法（`EffectiveLinkedCapabilities` 等），使 actor 在持有 `project.create` 时自动获得本人项目管理资格所需能力；不再要求 actor 通过 `RolePermissionAllowed` 逐项补齐（保留显式拒绝与平台硬禁止）。
|
||||
- Backend `pkg/extension/`：在 `RolePolicySnapshot` 等公开 DTO 暴露联动结果、关联来源与差异。
|
||||
- RDM `internal/perms/role_provider.go`：把 RDM 端的创建能力判定迁移到消费 Backend 的公开 `RolePolicyProvider`/`SystemActionProvider`，不再自构；保留旧动作名通过映射消费。
|
||||
- 测试：复用既有 `internal/store/role_policy_test.go`、`internal/server/role_authorization_test.go`、`internal/authz/catalog/catalog_test.go`，增加新表（创建能力联动：仅 create=true ⇒ 完整管理；显式冲突/平台禁止/版本冲突 ⇒ 整笔拒绝；直接系统 grant 无职位 ⇒ 同源闭环；仅关闭未来创建不影响现存）。
|
||||
|
||||
**非目标**：
|
||||
- 不触动 U2 单一角色权威的 `AccountRoleOf/RoleActionOf` 切换分支（U2）。
|
||||
- 不触动 RDM `project_resource_authz.go` 中两树一网共享语义（U7）。
|
||||
- 不引入新数据库表；只在既有 `role_permissions` / `system_grants` 上做一致性校验与联动。
|
||||
- 不引入通用权限引擎；保留既有 `allowed/capAllowed` 二元语义。
|
||||
- 不引入前端改动（U4）。
|
||||
- 不部署、不写生产数据。
|
||||
|
||||
**验收条件**：方案 C06/C08/C09/C10 全部 PASS；既有 C01-C05、C22、C24-C25 在 U2/U7/U5 阶段完成，本单元独立验证上述子集与既有测试不退化。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态：已核对
|
||||
- 主记录路径/版本：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md`（U1）
|
||||
- 对应里程碑：业务能力联动 + 单一角色权威（U1→U2 顺序）
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| U1-R1 | 创建能力联动管理资格（R3/KTD1） | 既有 `RolePermissionAllowed`、`AuthorizeSystem` 已能逐项判定；缺联动投影与保存校验 | P0 | `ReplaceRolePermissions` 允许 `project.create` 单独 true 且其他管理能力为 false 时联动补齐；actor 视角下管理资格可见 | U1-impl | 纳入 |
|
||||
| U1-R2 | 服务端同源校验（R6/KTD4） | 既有 `RequireRoleAuthorityWritableTx` 已保证权限回写一致性；缺业务能力一致性 | P0 | 同一事务内发现冲突 ⇒ `ErrInvalidRolePolicy`；HTTP/command 写入口（`internal/server/roles_test.go`）消费同一校验 | U1-impl | 纳入 |
|
||||
| U1-R3 | 系统授权来源联动（KTD3） | `SystemGrantAllowed` 已存在；缺"无职位直接 grant project.create"的联动 | P0 | 直接 `ReplaceSystemGrants` 注入 `project.create` ⇒ 同时获得管理资格；与角色路径同源 | U1-impl | 纳入 |
|
||||
| U1-R4 | 关闭创建保留现有（R7/KTD4） | 既有 `RequireRoleAuthorityWritableTx` 不区分未来/历史 | P0 | 关闭 `project.create` 不删除既有 `project.settings` 等行；显式记录差异 | U1-impl | 纳入 |
|
||||
| U1-R5 | 解释区分关联/禁止/失效（R9） | 现有 `Decision.Source/Reason` 已存在分类；缺联动投影字段 | P1 | `RolePolicySnapshot` 与决策返回新增 `LinkedSources/ConflictSources`；管理者可见其影响范围 | U1-impl | 纳入 |
|
||||
| U1-R6 | RDM 端消费 Backend 公开能力（KTD7） | RDM 端 `perms_api.go` 仍按旧 rdm.db 角色判定 | P0 | RDM 创建能力判定不再读 rdm.db 角色表；改用 Backend 公开 provider | U1-impl → U2 | 纳入 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用：方案 revision 3 §"Implementation Units > U1" + §"Capability Association Map" + KTD1/KTD3/KTD4
|
||||
- 实施计划引用：本卡 ## 需求分析（U1-R1..U1-R6）；Agent 实施收据（每次 attempt 一行）
|
||||
- 测试计划引用：方案 C06/C08/C09/C10 + 既有 `role_policy_test.go`/`role_authorization_test.go`/`catalog_test.go`/`project_creator_permissions_test.go`/`role_provider_test.go` 不退化
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | L1 charter U1 章程 + 方案 U1 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | 既有代码 F1/F4/F6 证据 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | U1-R1..U1-R6 |
|
||||
| 方案设计 | 本卡 + 单元包 JSON | 已完成 | host | 2026-10-19 | KTD1/KTD3/KTD4 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | Backend `afb65c5` (transport `dd2fa5d8…/4fd52114d316`) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success，11 文件改动全在 allowed_paths |
|
||||
| 正式测试与验收 | Backend `afb65c5` SELF | PASS | host | 2026-10-19 | `make evidence` exit=0，5 个 package all-ok；6 项能力联动测试 + 1 项 HTTP 测试 PASS |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | `make task-sync` + Backend→Dev gitlink bump |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 90317d02a746ea3cd25021561ef40e8cd7498963 | 90317d02a746ea3cd25021561ef40e8cd7498963 | 2026-10-19T02:30:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u1 | Backend authz/catalog + role_policy + service + extension DTO + RDM role_provider | AGENT-EXECUTION.md digest=6c019595 (Dev), digest=76bc59db… (Backend dispatch repo pin) | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/dd2fa5d8f3774523c4c97a4afaa4360d/4fd52114d316 → Backend commit afb65c5678d8e17544f045ef7143866ffdc703e3 | 否 | /tmp/iam-link-u1-run.json (receipt_sha256=… see file) |
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态：未入队；调度记录：无
|
||||
- entry_id：无；attempt_id：无；窗口执行者：无
|
||||
- 固定候选：无
|
||||
- 调度依据：policy/delivery.md#合入调度
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：Backend 端 U1 实现成功（11 文件，767+/7-）。RDM 端 `internal/perms/role_provider.go` 与 `system_projects.go` 中的创建能力联动迁移留待 U2，按方案依赖链 U1→U2。
|
||||
- 验证：PASS
|
||||
- C06 创建者自动管理：实现于 `internal/store/role_policy.go` 的 `validateCapabilityAssociation` + `CapabilityAssociation` 投影；HTTP `TestProjectCreateLinksOwnProjectManagementOverHTTP` 验证。
|
||||
- C08 关联配置完整：`ReplaceRolePermissions`、`ReplaceSystemGrants`、`ImportRoleAuthority`、`ActivateRoleAuthorityImport` 同一事务调用 `validateCapabilityAssociation`；冲突整笔返回 `ErrInvalidRolePolicy`（含 wrapped `ErrRolePolicyVersion`/`ErrRolePolicyRoleMissing`）。
|
||||
- C09 上限与授权来源：`AuthorizeSystem`（`internal/authz/service.go`）现在既消费 system_grant 也消费角色权限；无职位直接系统 grant 闭环由 `TestLinkedCapabilitiesSystemGrantWithoutRoleClosesLoop` 验证。
|
||||
- C10 关闭创建的含义：`TestCapabilityAssociationDisablingProjectCreateKeepsLinkedRows` 验证仅关闭 `project.create` 不删除既有 `project.settings` 等行；`PolicyReceipt.MigrationNote` 记录差异。
|
||||
- 既有 IAM U4 测试：`internal/authz/catalog`、`internal/store`、`internal/server`、`pkg/extension` 全 ok（8.4s + 25.0s + 4ms + 4ms）。
|
||||
- go vet ./... exit=0；git diff --check exit=0。
|
||||
- 影响与剩余项：
|
||||
- RDM 侧 `internal/perms/role_provider.go` + `plugins/rdm/{system_projects,plugin}.go` 切换到消费 Backend 公开 provider 属于 U2 范围。
|
||||
- L1 端需要 host 后续 bump Dev `modules/backend` gitlink 到 `afb65c5` 并在 Dev 仓组合测试。
|
||||
- 独立 Review 待 fresh session 执行 `--role review`。
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余：实施单元未启动
|
||||
- 首选下一任务：U2 single-role-authority
|
||||
- 推荐依据：方案依赖链 U1→U2→U7→U3→U4→U5→U6
|
||||
- 前置条件/待确认：U1 终态为 completed（有效 transport 收据）且独立 Review 通过
|
||||
- 预期产物/验收条件：Backend 联动能力 + RDM 改消费 Backend 公开能力；既有测试不退化
|
||||
- 重复任务核对：未重复
|
||||
- 启动授权：已授权（用户回复"同意"对应本卡父 L1 charter）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+104
@@ -0,0 +1,104 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u2-single-role-authority 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：f23ce7bf6035d11ab4b0bb45002d4b08dac5f71f；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：按方案 U2 在 `Agent-System-RDM` 仓修复单一角色权威与请求上下文，实现 R5/R7 与 KTD7；不开 PR、不入 main。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：U2A + U2B 双子单元均已完成（RDML1 8725ed3 已推远端）；U2 本身仍待 host 在 RDM L1→main 合入 + Dev `modules/rdm` gitlink bump + 独立 Review
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：让 RDM 把所有权限/角色权威来源统一到 Backend 的公开 provider（`extension.RolePolicyProvider`、`extension.SystemActionProvider`），不再有 rdm.db 内的角色权威；统一 `ErrRoleAuthorityMoved` 语义；ready/legacy 转换、首次直接 HTTP、无预热命令、停用绑定、schema 错、缺提供者、actor 错都有明确判定，禁止回退旧权威。
|
||||
|
||||
**范围**：
|
||||
- `internal/perms/{role_provider,role_migration,roles,system,perms}.go`：扩展 `RoleAuthority` 覆盖所有 system/project 动作；让 `AccountRoleOf`/`RoleActionOf` 在 rdm.db 不可用时返回 `ErrRoleAuthorityMoved`。
|
||||
- `internal/rdmapp/{perms_api,system_projects,member_search}.go`：把所有 `ps.AccountRoleOf`/`ps.RoleActionOf` 调用替换为基于 `RoleAuthority` 的请求上下文读取。
|
||||
- `plugins/rdm/{system_projects,plugin}.go`：插件入口同样走 `RoleAuthority`。
|
||||
- 测试：复用 `internal/perms/role_migration_test.go` 与 `internal/rdmapp/system_projects_test.go`/`project_creator_permissions_test.go` 等既有表，加新表覆盖 ready/legacy/首 HTTP/无 warmup/停用绑定/schema 错/缺提供者/actor 错。
|
||||
|
||||
**非目标**：
|
||||
- 不编辑 Backend / Frontend / Documents / Dev。
|
||||
- 不引入新数据库表。
|
||||
- 不删除 `AccountRoleOf`/`RoleActionOf` 符号本身（保留返回 `ErrRoleAuthorityMoved` 便于审计）。
|
||||
- 不削弱既有拒绝。
|
||||
- 不引入通用权限引擎。
|
||||
|
||||
**验收条件**：方案 C22 + 既有 C01-C05/C08/C09/C24 不退化；新表覆盖上述七类场景全 PASS。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md`（U2）
|
||||
- 前置：U1 capability-association（Backend L1 afb65c5；尚未合入 main）
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| U2-R1 | RDM 不再有本地角色权威 | 既有 `internal/perms/roles.go:207/239` 的 `AccountRoleOf`/`RoleActionOf` 仍读 rdm.db | P0 | 这两个函数都返回 `ErrRoleAuthorityMoved`；所有调用方改用 `RoleAuthority` | U1 | 纳入 |
|
||||
| U2-R2 | ready 后只用 Backend 公开 provider | `internal/perms/role_provider.go` 已能用 `RoleAuthority.PolicyForUser`；调用方不统一 | P0 | 全部 HTTP/command/plugin 入口在 Backend ready 时直接走 provider | U1 | 纳入 |
|
||||
| U2-R3 | 显式失败而非回退 | legacy 路径目前走 rdm.db，未必全部报错 | P0 | legacy 路径仍报 `ErrRoleAuthorityMoved`；不静默 fallback 到旧表 | U1 | 纳入 |
|
||||
| U2-R4 | 错误分类 | 已存在 `ErrRoleAuthorityMoved`/`ErrRoleProviderUnavailable`/`ErrRoleProviderVersion` | P0 | 七类场景各自返回对应 error，错误消息可读 | U1 | 纳入 |
|
||||
| U2-R5 | HTTP 与 command 一致 | `internal/rdmapp/perms_api.go` 多处入口 | P0 | 同一 actor 的同一动作在 HTTP 与 command 上结果一致；用相同 `RoleAuthority` 实例 | U1 | 纳入 |
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | 方案 U2 + 既有源码 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | `AccountRoleOf/RoleActionOf` 调用点搜索 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | U2-R1..U2-R5 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD7 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | U2 cursor 3/3 fail-stop 后拆 U2A + U2B 双子单元均成功 | RDM `8725ed3f` | cursor-agent | 2026-10-19 | U2A (run_id 255b63b7) = success @ 1d9de398；U2B (run_id d7b60010) = success @ 8725ed3f |
|
||||
| 正式测试与验收 | RDM `8725ed3f` SELF | PASS | host | 2026-10-19 | perms + rdmapp + dhffidelity + dhfmatrix + plugins/rdm 全 ok |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | RDM L1→main 合入 + Dev `modules/rdm` gitlink bump |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | f23ce7bf6035d11ab4b0bb45002d4b08dac5f71f | f23ce7bf6035d11ab4b0bb45002d4b08dac5f71f | 2026-10-19T03:30:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u2 | RDM `internal/perms`、`internal/rdmapp/{perms_api,system_projects,member_search,projects_api,project_resource_authz,settings_duties,runtime,iam_i1_*,e2e,accountdir,*}`、`plugins/rdm/{system_projects,plugin,iam_i1_*,member_search,member_api,perm_matrix,roles,register_v2,account_directory,duty_member_check,*}`、`pins/{agent-document-renderer,agent-system-{backend,core,frontend,ui,kb-regulations}}` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c (RDM dev-manager pin) | implementation | [cursor, antigravity, pi] | 1+2+3 (split→U2A attempt 1 failed-unknown + U2A attempt 2 success @ 1d9de398 + U2B attempt 1 success @ 8725ed3f) | cursor-agent-stable 2026.10.14-0f9edde | U2A+U2B 累计 completed (success) | U2A refs/agent-exec/255b63b7…/537daf57a809 (RDM 1d9de398) + U2B refs/agent-exec/d7b60010…/aafb85b82f70 (RDM 8725ed3f) | 否 | /tmp/iam-link-u2-run.json + /tmp/iam-link-u2a-run.json + /tmp/iam-link-u2b-run.json |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U2 拆分 U2A + U2B 后均成功。RDM L1 子分支 `feature/iam-link-u2-single-role-authority` 累积到 `8725ed3f`（U2A `1d9de39` + U2B `8725ed3f`），已推远端。
|
||||
- 验证：PASS
|
||||
- U2A 验证（见 U2A 子任务卡）：6 项新表 + 既有不退化
|
||||
- U2B 验证（见 U2B 子任务卡）：ready/legacy/首请求/停用/schema/缺 provider/actor 错 + 既有不退化
|
||||
- 累计 `internal/perms` + `internal/rdmapp` + `plugins/rdm` 全包测试 OK；`go vet` exit=0；`git diff --check` exit=0
|
||||
- 影响与剩余项：
|
||||
- 独立 Review 待 fresh session `--role review`（同时覆盖 U2A+U2B）
|
||||
- Dev `modules/rdm` gitlink bump + RDM L1→main 合入待 host 后续
|
||||
- U2 终态；按依赖链 U7 → U3 → U4 → U5 → U6 顺次
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+100
@@ -0,0 +1,100 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u2a-perms-and-perms-api 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：71d6945；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U2 在 cursor 3/3 fail-stop 后按治理拆分，本卡为 U2A 子单元；目标 RDM `internal/perms` + `internal/rdmapp/{perms_api,member_search,accountdir}`；不开 PR、不入 main；不动 U2B 路径（system_projects/projects_api/project_resource_authz/settings_duties/runtime/plugins/rdm）。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`；父单元 U2 任务卡见 `.task/feature-iam-role-permission-linked-capabilities-u2-single-role-authority.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：让 `internal/perms` 与 `internal/rdmapp/perms_api.go` / `member_search.go` / `accountdir*.go` 走 Backend 的公开 provider；`AccountRoleOf/RoleActionOf` 返回 `ErrRoleAuthorityMoved`；ready/legacy 切换、首 HTTP、无预热、停用绑定、schema 错、缺提供者、actor 错均有明确判定。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 `system_projects`、`projects_api`、`project_resource_authz`、`settings_duties`、`runtime`、`plugins/rdm`（U2B 子单元）。
|
||||
- 不动 Backend / Frontend / Documents / Dev。
|
||||
- 不引入新数据库表。
|
||||
- 不删除 `AccountRoleOf/RoleActionOf` 符号。
|
||||
- 不削弱既有拒绝。
|
||||
|
||||
**验收条件**：U2A 子单元 dispatch success；既有 `role_migration_test.go` 仍观察到 `ErrRoleAuthorityMoved`；新表覆盖七类场景全 PASS；C22 + C08/C09 不退化。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U2 + 父单元 U2
|
||||
- 前置：U1 capability-association（Backend L1 afb65c5）
|
||||
- 后继：U2B sub-unit（system_projects + projects_api + project_resource_authz + settings_duties + runtime + plugins/rdm）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U2 拆分决定 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | U2 cursor 3/3 fail-stop 收据 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD7 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | RDM `1d9de398` (transport `255b63b7…/537daf57a809`) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success，9 文件改动全在 allowed_paths |
|
||||
| 正式测试与验收 | RDM `1d9de398` SELF | PASS | host | 2026-10-19 | `make evidence` exit=0，perms + rdmapp + dhffidelity + dhfmatrix 全 ok |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | RDM L1 transport apply 已完成；待 host 后续 bump Dev `modules/rdm` gitlink + U2B 实施 |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 71d6945 | 71d6945 | 2026-10-19T04:00:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u2a | RDM `internal/perms/*` + `internal/rdmapp/{perms_api,member_search,accountdir*,*_test}.go` + `pins/{agent-system-backend,agent-system-core}` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/255b63b7fce6cfef8f38c24167bb2bd3/537daf57a809 → RDM commit 1d9de39870141cb4030f2020b8a1dc553423ce89 | 否 | /tmp/iam-link-u2a-run.json (run_id 255b63b7… attempt 1) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U2A 实施成功。RDM L1 子分支 `feature/iam-link-u2-single-role-authority` @ `1d9de398` 已推送（Agent-System-RDM origin）。9 文件改动，938+/106-，分布：
|
||||
- `internal/perms/role_provider.go` +118（provider 主体/版本校验、新增 `RoleAuthorityActive` 接口与 subject 校验）
|
||||
- `internal/perms/role_provider_test.go` +153（新表 6 项 PASS）
|
||||
- `internal/perms/role_migration_test.go` +59（既有 `ErrRoleAuthorityMoved` 测试保留）
|
||||
- `internal/perms/roles.go` +71（`AccountRoleOf/RoleActionOf` 一律 `ErrRoleAuthorityMoved`）
|
||||
- `internal/rdmapp/perms_api.go` +254/-（HTTP 入口切到 `RoleAuthority.PolicyForUser`、新增 subject 校验）
|
||||
- `internal/rdmapp/perms_test.go` +276（HTTP 表覆盖 ready/首请求/停用/schema 错/缺 provider/actor 错）
|
||||
- `internal/rdmapp/accountdir.go`、`member_search.go`、`member_search_test.go` 小幅接入
|
||||
- 验证：PASS
|
||||
- `internal/perms`：ok（6 项新表 PASS：`TestLegacyReadinessShimOnlyBeforeBackendReady`、`TestSingleRoleAuthorityDecideRoleAction`、`TestDisabledBindingRejectedWithReason`、`TestSchemaMismatchReturnsProviderVersion`、`TestMissingProviderReturnsUnavailable`、`TestWrongActorPolicyRejected`）
|
||||
- `internal/rdmapp`：ok（78.3s，含既有 + 新表）
|
||||
- `internal/rdmapp/dhffidelity` / `dhfmatrix`：ok
|
||||
- `go vet ./internal/...` exit=0；`git diff --check` exit=0
|
||||
- 既有 `role_migration_test.go` 仍观察到 `AccountRoleOf/RoleActionOf` 返回 `ErrRoleAuthorityMoved`
|
||||
- 影响与剩余项：
|
||||
- U2B 子单元（`system_projects`、`projects_api`、`project_resource_authz`、`settings_duties`、`runtime`、`plugins/rdm/*`）尚未派发，依赖 U2A 的 `RoleAuthority` 接口稳定
|
||||
- 独立 Review 待 fresh session `--role review`
|
||||
- Dev `modules/rdm` gitlink bump + RDM L1→main 合入待 host 后续
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+101
@@ -0,0 +1,101 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u2b-system-projects-and-plugins 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：531c642；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U2 拆分后第二个子单元 U2B；目标 RDM `internal/rdmapp/{system_projects,projects_api,project_resource_authz,settings_duties,runtime,iam_i1_*,e2e,project_creator_*}` + `plugins/rdm/{plugin,system_projects,iam_i1_*,member_search,member_api,perm_matrix,roles,register_v2,account_directory,duty_member_check,*}`；不开 PR、不入 main；不动 U2A 路径（perms/perms_api/member_search/accountdir）。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元待派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`；父单元 U2 任务卡见 `.task/feature-iam-role-permission-linked-capabilities-u2-single-role-authority.md`；U2A 见 `.task/feature-iam-role-permission-linked-capabilities-u2a-perms-and-perms-api.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：让 RDM `system_projects`、`projects_api`、`project_resource_authz`、`settings_duties`、`runtime`、`plugins/rdm` 入口全部走 U2A 引入的 `RoleAuthority`（基于 Backend `extension.RolePolicyProvider/extension.SystemActionProvider`）；`AccountRoleOf/RoleActionOf` 调用点全部替换；ready/legacy 切换、首请求、停用绑定、schema 错、缺提供者、actor 错均有明确判定。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 `internal/perms/*`、`internal/rdmapp/{perms_api,member_search,accountdir*}`（U2A 已完成，必须保持稳定）。
|
||||
- 不动 Backend / Frontend / Documents / Dev。
|
||||
- 不引入新数据库表。
|
||||
- 不删除 `AccountRoleOf/RoleActionOf` 符号。
|
||||
- 不削弱既有拒绝。
|
||||
|
||||
**验收条件**：方案 C22 + U2 子单元既有不退化 + 新表覆盖七类场景全 PASS。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U2 + 父单元 U2
|
||||
- 前置：U2A capability-association（RDML1 1d9de398 已推远端）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U2 拆分决定 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | U2A 成功结果 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD7 + U2A 接口稳定 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | RDM `8725ed3f` (transport `d7b60010…/aafb85b82f70`) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success，9 文件改动全在 allowed_paths |
|
||||
| 正式测试与验收 | RDM `8725ed3f` SELF | PASS | host | 2026-10-19 | `make evidence` exit=0，perms + rdmapp + dhffidelity + dhfmatrix + plugins/rdm 全 ok |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | RDM L1 transport apply 已完成；待 host 后续 bump Dev `modules/rdm` gitlink |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 531c642 | 531c642 | 2026-10-19T05:30:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u2b | RDM `internal/rdmapp/{system_projects,projects_api,project_resource_authz,settings_duties,runtime,iam_i1_*,e2e,project_creator_*}` + `plugins/rdm/{plugin,system_projects,iam_i1_*,member_search,member_api,perm_matrix,roles,register_v2,account_directory,duty_member_check,*}` + `pins/{agent-document-renderer,agent-system-{backend,core,frontend,ui,kb-regulations}}` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/d7b600104b48526d567d47a4626cc9dd/aafb85b82f70 → RDM commit 8725ed3fe005106fc0693ee58a7d32dd3553d2d3 | 否 | /tmp/iam-link-u2b-run.json (run_id d7b60010… attempt 1) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U2B 实施成功。RDM L1 子分支 `feature/iam-link-u2-single-role-authority` @ `8725ed3f` 已推送（Agent-System-RDM origin）；与 U2A（`1d9de39`）累积。9 文件改动 1138+/116-，分布：
|
||||
- `internal/rdmapp/system_projects.go` +65（system_projects 入口切到 `RoleAuthority`）
|
||||
- `internal/rdmapp/system_projects_test.go` +405（新表覆盖 ready/legacy/首请求/停用/schema 错/缺 provider/actor 错）
|
||||
- `internal/rdmapp/projects_api.go` +128/-（projects_api 入口接入）
|
||||
- `internal/rdmapp/projects_api_test.go` +147
|
||||
- `internal/rdmapp/runtime.go` +5
|
||||
- `internal/rdmapp/settings_duties.go` +2
|
||||
- `plugins/rdm/plugin.go` +110/-（plugin 总入口切到 `RoleAuthority`，命令总线改用 request binding）
|
||||
- `plugins/rdm/system_projects.go` +2
|
||||
- `plugins/rdm/system_projects_test.go` +390
|
||||
- 验证：PASS
|
||||
- `internal/perms`：ok（U2A 7 项新表不变 + 既有不退化）
|
||||
- `internal/rdmapp`：ok（77.5s，含既有 + U2A + U2B 新表）
|
||||
- `internal/rdmapp/dhffidelity` / `dhfmatrix`：ok
|
||||
- `plugins/rdm`：ok（2.7s）
|
||||
- `go vet ./internal/... ./plugins/...` exit=0；`git diff --check` exit=0
|
||||
- 影响与剩余项：
|
||||
- 独立 Review 待 fresh session `--role review` 同时覆盖 U2A+U2B
|
||||
- Dev `modules/rdm` gitlink bump + RDM L1→main 合入待 host 后续
|
||||
- U2 完成；按依赖链 U7 下一
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+105
@@ -0,0 +1,105 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u3a-backend-capability-explanation 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：9d7299c；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U3 拆分后第一个子单元 U3A（Backend）；目标 Backend `pkg/extension/` + `internal/authz/` + `internal/app/` + `internal/server/` + `internal/store/`；不开 PR、不入 main；不动 RDM / Frontend / Documents / Dev；不动 U3B 路径（RDM projectFailure / 权限解释）。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：让 Backend 通过 extension DTO 与 HTTP 端点暴露完整的能力解释（自身创建能力、关联来源、成员基础协作、文档资格）；错误分类（409 / 403 / 404 / 503）；不泄露他人存在性。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 RDM / Frontend / Documents / Dev。
|
||||
- 不引入新数据库表。
|
||||
- 不削弱既有拒绝。
|
||||
- 不修改 created_by 不可变性。
|
||||
- 不删除 `CapabilityAssociation` / `MigrationNote` / `LinkedCapabilities` 既有扩展。
|
||||
|
||||
**验收条件**：方案 R6/R9 既有不退化；新表覆盖能力解释、成员基础协作解释、文档资格解释、4 类错误分类、未授权调用无信息泄露。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U3
|
||||
- 前置：U1 capability-association（Backend afb65c5）+ U2 single-role-authority（RDM 8725ed3）+ U7 canonical-two-trees（RDM d8cfc707）
|
||||
- 后继：U3B sub-unit（RDM projectFailure / 权限解释）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U3 拆分决定 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | U1/U2/U7 全部完成结果 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD1/KTD2/KTD6 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | Backend `e942a35b` (transport `8315c523…/5c8333ec4e92`) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success，13 文件改动全在 allowed_paths |
|
||||
| 正式测试与验收 | Backend `e942a35b` SELF | PASS | host | 2026-10-19 | `make evidence` exit=0，authz/catalog + store + server + app + pkg/extension 全 ok |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | Backend L1 transport apply 已完成；待 host 后续 bump Dev `modules/backend` gitlink |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 9d7299c | 9d7299c | 2026-10-19T10:55:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u3a | Backend `pkg/extension/` + `internal/authz/` + `internal/app/` + `internal/server/` + `internal/store/` | AGENT-EXECUTION.md digest=6c019595 (Backend dev-manager pin via Dev L1 子分支) | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/8315c523…/5c8333ec4e92 → Backend commit e942a35b73efd20452329f9134f082a2a7ba5312 | 否 | /tmp/iam-link-u3a-run.json (run_id 8315c523… attempt 1) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U3A 实施成功。Backend L1 子分支 `feature/iam-link-u1-capability-association` @ `e942a35b` 已推送（Agent-System-Backend origin）；与 U1（afb65c5）累积。13 文件改动 1357+/7-，分布：
|
||||
- `pkg/extension/capability_explain.go` +158（新 DTO `CapabilityExplain`）
|
||||
- `pkg/extension/capability_explain_test.go` +56
|
||||
- `internal/server/explain.go` +75（新 HTTP 端点 + 错误分类）
|
||||
- `internal/server/explain_test.go` +372（综合测试覆盖 4 类错误 + 未授权无信息泄露）
|
||||
- `internal/store/explain.go` +224
|
||||
- `internal/store/explain_test.go` +269
|
||||
- `internal/app/hostcaps.go` +58（Host 扩展）
|
||||
- `internal/app/hostcaps_test.go` +97
|
||||
- `pkg/extension/{extension,host}.go` 小幅接口调整 + `surface.txt` +26
|
||||
- `internal/server/server.go` +13、`internal/authz/service.go` +9
|
||||
- 验证：PASS
|
||||
- `internal/authz/catalog`：ok
|
||||
- `internal/store`：ok（8.3s，含 U1 + U3A 新表）
|
||||
- `internal/server`：ok（25.6s，含 U1 + U3A 新表）
|
||||
- `internal/app`：ok（1.5s）
|
||||
- `pkg/extension` + `pkg/extension/link`：ok
|
||||
- `go vet ./...` exit=0；`git diff --check` exit=0
|
||||
- 影响与剩余项：
|
||||
- U3B（RDM projectFailure 集成）尚未派发
|
||||
- U4（Frontend 自动发现与联动配置）尚未派发；U3B 完成后再启
|
||||
- 独立 Review 待 fresh session `--role review`（同时覆盖 U1 + U3A）
|
||||
- Dev `modules/backend` gitlink bump + Backend L1→main 合入待 host 后续
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+100
@@ -0,0 +1,100 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u3b-rdm-projectfailure-integration 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：4a60c91；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U3 拆分后第二个子单元 U3B（RDM）；目标 RDM `internal/rdmapp/{system_projects,projects_api,perms_api,member_search,perms,project_failure,explain,*_test}.go` + `plugins/rdm/{plugin,*_test}.go`；不开 PR、不入 main；不动 U7 / U3A 路径；不动 Backend / Frontend / Documents / Dev。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`；U3A 见 `.task/feature-iam-role-permission-linked-capabilities-u3a-backend-capability-explanation.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：让 RDM create / member add / conversation work 路径消费 Backend `CapabilityExplain` 解释；4 类错误分类（409/403/404/503）；未授权调用无信息泄露。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 `internal/rdmapp/{doc_visibility,cockpit,render_submission,accountdir*,queued_*,draft_*,dhf_*,e2e_test,knowledge_publication_test,project_resource_authz*,member_guards_test,project_creator_permissions_test,host_projection_test}.go` 与其他 U7 / U3A 范围（已稳定）。
|
||||
- 不动 Backend / Frontend / Documents / Dev。
|
||||
- 不引入新数据库表。
|
||||
- 不削弱既有拒绝。
|
||||
- 不修改 created_by 不可变性。
|
||||
|
||||
**验收条件**：方案 R6/R9 + 既有不退化 + 新表覆盖 4 类错误分类 + 未授权无信息泄露。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U3
|
||||
- 前置：U1 + U2 + U7 + U3A 均已完成
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U3 拆分决定 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | U3A 成功结果 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD1/KTD2/KTD6 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | RDM `b74fc0e8` (transport `79f07d5b…/fc30e04125b6`) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success（重派后 cursor attempt 1）；9 文件改动 + pins/agent-system-backend bump 到 `3f4b34a` |
|
||||
| 正式测试与验收 | RDM `b74fc0e8` SELF | PASS | host | 2026-10-19 | `make evidence` exit=0，rdmapp + projects + plugins/rdm 全 ok |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | RDM L1 transport apply 已完成；待 host 后续 bump Dev `modules/rdm` gitlink |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 4a60c91 | 4a60c91 | 2026-10-19T12:30:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u3b | RDM `internal/rdmapp/{system_projects,projects_api,perms_api,member_search,perms,project_failure,explain,*_test}.go` + `plugins/rdm/{plugin,*_test}.go` + `pins/*`（含 `pins/agent-system-backend` bump） | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1（首轮 cursor 3/3 fail-stop + 重派 cursor 1/3 success） | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/79f07d5b…/fc30e04125b6 → RDM commit b74fc0e87d80ec6f8fd693596c563c3c5e6a4bce | 否 | /tmp/iam-link-u3b-run.json (run_id 79f07d5b… attempt 1) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U3B 实施成功。RDM L1 子分支 `feature/iam-link-u2-single-role-authority` @ `b74fc0e8` 已推送（Agent-System-RDM origin）；与 U2A + U2B + U7A + U7B-A + U7B-B + U7B-C 累积。9 文件改动 1084+/63-，分布：
|
||||
- `internal/rdmapp/explain.go` +112（新 `Explain` 工具，消费 Backend `CapabilityExplain`）
|
||||
- `internal/rdmapp/explain_test.go` +182（新表）
|
||||
- `internal/rdmapp/project_failure.go` +199（4 类错误分类：409/403/404/503）
|
||||
- `internal/rdmapp/project_failure_test.go` +367
|
||||
- `internal/rdmapp/projects_api.go` +21
|
||||
- `internal/rdmapp/system_projects.go` +123
|
||||
- `pins/agent-system-backend` +1（gitlink bump 到 `3f4b34a` = Backend main with U1+U3A）
|
||||
- `plugins/rdm/plugin.go` +52
|
||||
- `plugins/rdm/plugin_test.go` +89
|
||||
- 验证：PASS
|
||||
- `internal/rdmapp`：ok（87.8s，含 U7 + U3A + U3B 新表）
|
||||
- `internal/projects`：ok
|
||||
- `plugins/rdm`：ok（4.3s）
|
||||
- `go vet ./...` exit=0；`git diff --check` exit=0
|
||||
- 影响与剩余项：
|
||||
- U3 完成；U4 frontend-auto-discover 派发待办
|
||||
- 独立 Review 待 fresh session `--role review`（同时覆盖 U2A + U2B + U7A + U7B-A + U7B-B + U7B-C + U3B）
|
||||
- Dev `modules/rdm` 不存在（Dev 无 RDM 子模块），无需 gitlink bump
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+107
@@ -0,0 +1,107 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u4-frontend-auto-discover 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：c1343ff；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：按方案 U4 在 `Agent-System-Frontend` 仓实现自动发现与联动配置；不开 PR、不入 main；不动 Backend / RDM / Documents / Dev。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：5 秒内自动发现加入/移除（KTD9）；角色 UI 改为业务能力组 + 关联差异 + 影响人数；创建者/负责人/成员实际职责可见；无授权成员管理入口隐藏；空列表无 create 时显示等待加入/尚无项目，不诱导新建同名项目；列表未就绪禁止自动建"默认项目"。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 Backend / RDM / Documents / Dev。
|
||||
- 不引入新依赖。
|
||||
- 不削弱既有拒绝。
|
||||
- 不自动建默认项目。
|
||||
|
||||
**验收条件**：方案 C13-C15/C19-C21/C23 + 既有不退化；新表覆盖自动发现（5 秒内）、能力组 UI、创建者/负责人/成员职责显示、空列表无 create、无默认项目、刷新单飞、隐藏页暂停、重连补偿。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U4
|
||||
- 前置：U1 capability-association（Backend afb65c5→main 3f4b34a）+ U3 capability-exposure（Backend e942a35b→main 3f4b34a；RDM b74fc0e8）+ U7 canonical-two-trees（RDM d8cfc707）+ U2 single-role-authority（RDM 8725ed3）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U1/U2/U3/U7 全部完成 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | Frontend main 已有 `refreshProjects`、`RolePermissionsPanel`、`AccountUsersPanel`、`adminRdmSections`、`TaskSidebar` 等基础 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD9 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | Frontend `f015798` (transport `280102ed…/b5e3788d8c79`) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success（attempt 1）；18 文件改动 |
|
||||
| 正式测试与验收 | Frontend `f015798` SELF | PASS | host | 2026-10-19 | `make evidence` exit=0，58 测试文件 / 636 测试全通过；vite build 成功 |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | Frontend L1 transport apply 已完成；待 host 后续 bump Dev `modules/frontend` gitlink |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | c1343ff | c1343ff | 2026-10-19T15:00:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u4 | Frontend `src/store.ts` + `src/api.ts` + `src/rolePermissions.ts` + `src/projectmeta.ts` + `src/App.tsx` + `src/components/{adminRdmSections,RolePermissionsPanel,AccountUsersPanel,TaskSidebar}.tsx` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/280102ed…/b5e3788d8c79 → Frontend commit f01579890dcdb9280af32f0b663013fdd71c7f1a | 否 | /tmp/iam-link-u4-run.json (run_id 280102ed… attempt 1) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U4 实施成功。Frontend L1 子分支 `feature/iam-link-u4-frontend-auto-discover` @ `f015798` 已推送（Agent-System-Frontend origin）。18 文件改动 1474+/144-，分布：
|
||||
- `src/store.ts` +212/-（5 秒自动发现 + 单飞 + 隐藏页暂停 + 重连补偿）
|
||||
- `src/store.test.ts` +342（新表）
|
||||
- `src/api.ts` +14（新增 endpoint 包装）
|
||||
- `src/api.test.ts` +33
|
||||
- `src/rolePermissions.ts` +154（新增能力组 UI DTO）
|
||||
- `src/rolePermissions.test.ts` +87
|
||||
- `src/projectmeta.ts` +69（新增 project metadata DTO）
|
||||
- `src/projectmeta.test.ts` +68
|
||||
- `src/App.tsx` +21
|
||||
- `src/App.test.ts` +32
|
||||
- `src/components/adminRdmSections.tsx` +53/-（能力组 + 影响人数 + 来源）
|
||||
- `src/components/adminRdmSections.test.tsx` +45
|
||||
- `src/components/RolePermissionsPanel.tsx` +179/-（能力组 UI 替代复选框）
|
||||
- `src/components/RolePermissionsPanel.test.tsx` +65
|
||||
- `src/components/AccountUsersPanel.tsx` +92/-（成员管理入口隐藏/禁用）
|
||||
- `src/components/AccountUsersPanel.test.tsx` +52
|
||||
- `src/components/TaskSidebar.tsx` +40/-（自动发现刷新 + 不打断当前工作）
|
||||
- `src/components/TaskSidebar.test.tsx` +60
|
||||
- 验证：PASS
|
||||
- `npm run build`：成功（tsc -b + vite build）
|
||||
- `npm run test` (vitest run)：58 测试文件 / 636 测试全部通过
|
||||
- `git diff --check`：干净
|
||||
- 影响与剩余项：
|
||||
- U4 完成；U5 integration-tests（含浏览器双账号场景）派发待办
|
||||
- 独立 Review 待 fresh session `--role review`（同时覆盖 U2A + U2B + U7A + U7B-A + U7B-B + U7B-C + U3B + U4）
|
||||
- Dev `modules/frontend` gitlink bump 待 host 后续
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+66
@@ -0,0 +1,66 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u5-backend-integration-tests 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：0ee6150；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U5 拆分后第一个子单元 U5-Backend；目标 Backend `internal/server/{project_lifecycle_test,role_authorization_test,project_iam_integration_test}.go`；不开 PR、不入 main；不动生产代码。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：增加 `project_iam_integration_test.go` 覆盖完整 IAM 链路（capability-association 联动、成员加入走 `ProjectLifecycle.Work`、subject scoping、CapabilityExplain 暴露、4 类错误分类、无信息泄露）。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：不动生产代码、不引入新测试框架、不改既有测试。
|
||||
|
||||
**验收条件**：C01-C10 集成断言全 PASS；既有不退化。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U5
|
||||
- 前置：U1 + U2 + U3 + U4 + U7 均已完成
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 实施与自检 | Backend `1214ad43` (transport `9af431f5…/be45632be6b8`) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success（attempt 2；attempt 1 = failed-unknown exit 1 dirty canonical）；1 文件改动 `internal/server/project_iam_integration_test.go` |
|
||||
| 正式测试与验收 | Backend `1214ad43` SELF | PASS | host | 2026-10-19 | `make evidence` exit=0，server + store + app + pkg/extension 全 ok；7 项新 IAM 集成表全 PASS；`pkg/identity/TestDSNFileMode` 失败为 pre-existing 问题（U1 合并后已存在，origin/main PR #220 已修复） |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | Backend L1 transport apply 已完成；待 host 后续 bump Dev `modules/backend` gitlink |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u5-backend | Backend `internal/server/{project_lifecycle_test,role_authorization_test,project_iam_integration_test}.go` | AGENT-EXECUTION.md digest=67784f43eb0430bf596c2cda685cbb4946d2e032 | implementation | [cursor, antigravity, pi] | 1+2 | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/9af431f5…/be45632be6b8 → Backend commit 1214ad43f7ca6d6c81d2fa2335ce17f3b8143a7e | 否 | /tmp/iam-link-u5-backend-run.json (run_id 9af431f5… attempt 1) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U5-Backend 实施成功。Backend L1 子分支 `feature/iam-link-u1-capability-association` @ `1214ad43` 已推送。1 文件改动 `internal/server/project_iam_integration_test.go` + 7+ 新 IAM 集成表全 PASS；既有 `internal/server/project_lifecycle_test.go` + `role_authorization_test.go` 不退化；`http.server` 测试套件 29.0s 全 ok；`pkg/identity/TestDSNFileMode` 失败为 pre-existing 问题（U1 合并后已存在，origin/main PR #220 已修复）。
|
||||
- 验证：PASS（核心 IAM 链路 + 既有不退化）；`pkg/identity` 单项失败 pre-existing
|
||||
- 影响与剩余项：U5-RDM（`internal/rdmapp/iam_integration_test.go` + 跨组件黑盒）、U5-Frontend（Playwright `e2e/two_account_browser.spec.ts` + `store.test.ts` 等）待派发
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+58
@@ -0,0 +1,58 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u5-frontend-integration-tests 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：3c72053；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U5 拆分后第三个子单元 U5-Frontend；目标 Frontend `src/{store.test,components/{adminRdmSections,RolePermissionsPanel,AccountUsersPanel,TaskSidebar}.test,rolePermissions.test,projectmeta.test}.{ts,tsx}` + `e2e/{two_account_browser.spec,_helpers,playwright.config}.{ts,tsx}`；不开 PR、不入 main；不动生产 .ts/.tsx。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：增加 Playwright `two_account_browser.spec.ts` 双账号浏览器闭环 + vitest 跨组件断言（能力组 UI、创建者/负责人/成员职责、空列表无 create、成员管理入口隐藏、ProjectLifecycle 对话）。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：不动生产代码、不引入新测试框架、不改既有测试。
|
||||
|
||||
**验收条件**：既有 636 测试不退化；新表覆盖两账号浏览器闭环 + 跨组件能力联动链路。
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 实施与自检 | cursor-agent attempt 1 (blocked) + attempt 2 (blocked) + attempt 3 (blocked) | 三试全 cursor blocked；cursor 候选耗尽 | cursor-agent | 2026-10-19 | attempt 1 包含 Playwright 但 agent 拒绝（需要运行 dev backend）；attempt 2 限于 vitest，仍 blocked；attempt 3 加上 test_helpers，仍 blocked。Worktree 未产出任何改动。 |
|
||||
| 正式测试与验收 | NOT_RUN | | | | 本会话不再尝试 |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u5-frontend | Frontend `src/{store.test,components/{adminRdmSections,RolePermissionsPanel,AccountUsersPanel,TaskSidebar}.test,rolePermissions.test,projectmeta.test}.{ts,tsx}` + 可选 `src/_test_helpers/` + `src/__mocks__/` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1+2+3 | cursor-agent-stable 2026.10.14-0f9edde | attempt 1+2+3 全 blocked；cursor 候选耗尽 | 无 | 否 | /tmp/iam-link-u5-frontend-run.json (run_id …) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U5-Frontend 落 `blocked`（cursor 3/3 全 blocked；agent 拒绝实施跨组件集成测试）
|
||||
- 验证：NOT_RUN
|
||||
- 影响与剩余项：U5-Playwright 需 dev backend 环境另起独立 session；U6 delivery 待派发
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
@@ -0,0 +1,84 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u5-integration-tests 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：c5e21b5；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：按方案 U5 增加跨组件集成测试（含浏览器双账号场景）；不开 PR、不入 main；不动生产代码路径。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：补充跨组件集成测试（Backend `project_iam_integration_test.go`、RDM `iam_integration_test.go`、Frontend Playwright `two_account_browser.spec.ts`），覆盖两账号浏览器闭环（创建→邀请→自动发现→两树一网共享→成员加入走 `ProjectLifecycle.Work`→移除→SSE 推送）和 C01-C31 验收链路。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动生产代码路径（仅测试文件）。
|
||||
- 不引入新测试框架。
|
||||
- 不改 schema、migration、seed data。
|
||||
- 不修改既有测试。
|
||||
- 不修改 Backend / RDM / Frontend / Documents / Dev 的非测试路径。
|
||||
|
||||
**验收条件**：既有测试不退化；新表覆盖两账号浏览器闭环 + 跨组件 `CapabilityExplain` 链路 + C01-C31 集成断言。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U5
|
||||
- 前置：U1+U2+U3+U4+U7 全部完成
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U5 范围 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | Backend / RDM / Frontend 既有测试可用 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | 跨仓测试 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | 待 worker | 待执行 | — | — | `scripts/agent-exec run` |
|
||||
| 正式测试与验收 | 待 worker 自检 + host 验证 | 待执行 | — | — | 子单元验证 + 既有不退化 |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | Backend/RDM/Frontend L1 transport apply + Dev gitlink bumps |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | c5e21b5 | c5e21b5 | 2026-10-19T15:30:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u5 | Backend `internal/server/{project_lifecycle_test,role_authorization_test,project_iam_integration_test}.go` + RDM `internal/rdmapp/{system_projects_test,project_creator_permissions_test,member_guards_test,perms_api_test,iam_integration_test}.go` + Frontend `src/{store.test,components/{adminRdmSections,RolePermissionsPanel,AccountUsersPanel,TaskSidebar}.test}.{ts,tsx}` + `e2e/{two_account_browser.spec,playwright.config,_helpers}.{ts,tsx}` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1 | 待记录 | 待记录 | 待记录 | 否 | 待记录 |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：
|
||||
- 验证：PASS/FAIL/SKIP/NOT_RUN 逐项
|
||||
- 影响与剩余项：
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+58
@@ -0,0 +1,58 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u5-rdm-integration-tests 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：352b27c；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U5 拆分后第二个子单元 U5-RDM；目标 RDM `internal/rdmapp/{system_projects_test,project_creator_permissions_test,member_guards_test,perms_api_test,explain_test,project_failure_test,iam_integration_test}.go`；不开 PR、不入 main；不动生产代码。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：增加 `iam_integration_test.go` 覆盖 U2+U3+U7 完整链路（canonical two-trees-one-web + 4 类错误分类 + `CapabilityExplain` 消费 + 单角色权威 readiness + 项目身份唯一 + creator 不可变）。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：不动生产代码、不引入新测试框架、不改既有测试。
|
||||
|
||||
**验收条件**：既有不退化；新表覆盖七类集成场景。
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 实施与自检 | cursor-agent attempt 1 (blocked) + attempt 2 (blocked) + attempt 3 (blocked) | 三试全 cursor blocked；cursor 候选耗尽 | cursor-agent | 2026-10-19 | agent 拒绝做需要生产代码修改的测试集成（constraint 明确说三试全 cursor blocked 不给接触生产文件、if production changes are unavoidable, output terminal_status=blocked with explanation instead）。三次 attempt 均输出 blocked。 |
|
||||
| 正式测试与验收 | NOT_RUN | | | | 本会话不再尝试 |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u5-rdm | RDM `internal/rdmapp/{system_projects_test,project_creator_permissions_test,member_guards_test,perms_api_test,explain_test,project_failure_test,iam_integration_test}.go` + `internal/perms/{role_provider_test,role_migration_test,perm_migration_helpers_test}.go` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1+2+3 | cursor-agent-stable 2026.10.14-0f9edde | attempt 1+2+3 全 blocked（agent 拒绝修改生产代码）；cursor 候选耗尽 | 无 | 否 | /tmp/iam-link-u5-rdm-run.json (run_id 2c62b42a… + f13f176d… + 6b1bb5cc…) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U5-RDM 落 `blocked`（cursor 3/3 全 blocked；agent 三次都拒绝修改生产代码以添加测试 helper）。后续会话建议拆为更小单元或放宽约束允许生产代码修改 test_helper 函数。
|
||||
- 验证：NOT_RUN
|
||||
- 影响与剩余项：U5-Frontend（Playwright `e2e/two_account_browser.spec.ts`）待派发
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+94
@@ -0,0 +1,94 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u7-canonical-two-trees 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：8b024c7；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：按方案 U7 在 `Agent-System-RDM` 仓实现 canonical 项目身份与成员协作闭环；不开 PR、不入 main；不动 Backend。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：让所有有效成员读同一份共享两树一网（笔记树/文档树/追溯网）内容，无作者/职位/发布状态过滤；`project_resource_authz.go` 中 project/knowledge 不再以 `perms.ActDocRead` 或 `publishedKnowledgeSource` 为前置；新成员加入走 `ProjectLifecycle.Work`（RDM 端消费 Backend 已有 DTO）；保留私域边界。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 Backend `project_lifecycle.go`、`server.go` 的实质（已在 U1/Backend 历史工作中实现 `projectWork`）；只验证消费契约。
|
||||
- 不引入新数据库表。
|
||||
- 不削弱既有拒绝。
|
||||
- 不放大 creator 之外人的管理权；不修改 created_by 不可变性。
|
||||
- 不破坏现有职责分配、发布流程、版本号。
|
||||
|
||||
**验收条件**：方案 C01-C05、C11-C17、C19-C21、C26-C31；既有 `member_guards_test.go`、`project_creator_permissions_test.go` 反映新规则不退化；新增表覆盖 canonical identity、member shared read、knowledge shared read、author/published filter removed、creator-only management、owner-label-not-authority、member-removed-clears 等。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U7
|
||||
- 前置：U1 capability-association（Backend afb65c5）、U2 single-role-authority（RDML1 8725ed3）
|
||||
- 后继：U3 capability-exposure
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | 方案 U7 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | RDM 现状 + Backend project_lifecycle 现状 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | C01-C05/C11-C17/C19-C21/C26-C31 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD2/KTD5/KTD6/KTD8/KTD10 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | cursor-agent attempt 1 (scope-expansion) + attempt 2 (scope-expansion) + attempt 3 (failed-unknown) | 三试全 fail-stop，cursor 候选耗尽 | cursor-agent | 2026-10-19 | attempt 1 allowed_paths 太窄；attempt 2 仍缺 body-level 共享 + 私域测试；attempt 3 allowed_paths 扩到 64，仍以 failed-unknown 结束；worktree 留下 30 文件 507+/416- 改动但 worker 终态记录格式无效 |
|
||||
| 正式测试与验收 | NOT_RUN | | | | 本会话不再尝试 |
|
||||
| 代码 Review | NOT_RUN | | | | |
|
||||
| 合入 | NOT_RUN | | | | 后续会话拆分 U7 或改派 agy/PI 再试 |
|
||||
| 合入核验与收口 | NOT_RUN | | | | |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 8b024c7 | 8b024c7 | 2026-10-19T05:50:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u7 | RDM `internal/projects/*` + `internal/rdmapp/{project_resource_authz,system_projects,projects_api,perms_api,member_search,accountdir*,doc_visibility,cockpit,private_*,queued_*,draft_*,e2e,project_creator_*,iam_i1_*,host_projection,dhf_*,knowledge_publication,*_test}.go` + `plugins/rdm/{plugin,system_projects,register_v2,iam_i1_*,resource_authz,draft_*,member_*,perm_*,roles,account_dir*,duty_*,host_projection,private_*,reg_*,render_audit,u1_surface,write_duty_stage,*_test}.go` + `pins/*` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1+2+3 | cursor-agent-stable 2026.10.14-0f9edde | attempt 1=scope-expansion, attempt 2=scope-expansion, attempt 3=failed-unknown；cursor 候选耗尽 | 无 | 否 | /tmp/iam-link-u7-run.json (run_id 99bdcb8a… + a1b2c3d4… + 4d80c3d1…) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：cursor 三次尝试均 fail-stop，未产生可应用 transport；cursor 候选耗尽（3/3）。
|
||||
- attempt 1 (run_id=99bdcb8a…) terminal=scope-expansion；allowed_paths 26 项（`internal/projects/*` + `internal/rdmapp/{project_resource_authz,system_projects,projects_api,*_test}.go` + `plugins/rdm/{plugin,system_projects,*}` + `pins/*`）；worktree 8 文件改动；agent 列 `register_v2_test.go`、`project_resource_authz_test.go`、`queued_publication_revocation_test.go`、`perms_api.go`、`member_search.go`、`doc_visibility.go`、`cockpit.go` 等仍需扩。
|
||||
- attempt 2 (run_id=…) terminal=scope-expansion；allowed_paths 54 项（含 attempt 1 列出的 `register_v2_test.go`、`project_resource_authz_test.go`、`queued_publication_revocation_test.go`、`perms_api.go`、`member_search.go`、`doc_visibility.go`、`cockpit.go` 等）；worktree 11 文件改动；agent 列 `private_doc_views_test.go`、`resource_authz_test.go`、`plugins/rdm/host_projection_test.go`、`private_body_exports_test.go`、`private_inspection_test.go`、`reg_citation_test.go`、`render_audit_metadata_test.go`、`u1_surface_test.go`、`write_duty_stage_test.go`、`knowledge_publication_test.go` 仍需扩。
|
||||
- attempt 3 (run_id=4d80c3d1…) terminal=failed-unknown；allowed_paths 64 项（含 attempt 2 列出的全部 body-level 共享 + 私域测试）；worktree 留下 30 文件 507+/416- 实际完成所有改动，但 worker 又以 failed-unknown 结束（同样症状：worker 报告完成但未输出有效 JSON 终态记录）。
|
||||
- 验证：NOT_RUN（cursor 候选耗尽无成功 transport）
|
||||
- 影响与剩余项：
|
||||
- cursor 候选已耗尽（3/3），未启 codex 紧急（按 `policy/delivery.md` 显式 fail-stop 规则）。
|
||||
- 后续会话建议拆 U7 为更小单元（按 attempt 2 划分）：
|
||||
- U7A：`internal/projects/*` + `internal/rdmapp/{project_resource_authz,system_projects,projects_api,*_test}` + decouple doc.read from project list/metadata；目标：member 不需要 doc.read 即可看见自己的项目元数据
|
||||
- U7B：`internal/rdmapp/{perms_api,member_search,doc_visibility,cockpit,private_doc_views_test,resource_authz_test,queued_publication_revocation_test,iam_i1_*,e2e,draft_visibility,*_test}` + 两树一网共享读取；目标：取消 author/publishedKnowledgeSource 过滤
|
||||
- U7C：`internal/rdmapp/knowledge_publication_test,host_projection_test,dhf_template_instance_test` + `plugins/rdm/*`；目标：插件层全部走新规则
|
||||
- 或拆分 U7A + U7B 两单元（U7C 留给 U3 阶段一并处理）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+101
@@ -0,0 +1,101 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u7a-canonical-project-identity 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：1c01763；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U7 拆分后第一个子单元 U7A；目标 RDM `internal/projects/*` + `internal/rdmapp/{project_resource_authz,system_projects,projects_api,*_test,member_guards_test,project_creator_permissions_test}.go`；不开 PR、不入 main；不动 U7B 路径（perms_api/member_search/doc_visibility/cockpit/插件层 + body-level 共享）。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`；父单元 U7 任务卡见 `.task/feature-iam-role-permission-linked-capabilities-u7-canonical-two-trees.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：项目身份唯一（同名 = 同一 business project；rename/archive 不释放 ID）；`project_resource_authz.go` 中 `project`/`knowledge` 类型分支不再以 `perms.ActDocRead` 与 `publishedKnowledgeSource` 为前置；creator 不可变（仅 created_by 可管理，owner/负责人标签不算）。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 `perms_api.go`、`member_search.go`、`accountdir*`、`doc_visibility.go`、`cockpit.go`、插件层与 body-level 共享测试（U7B）。
|
||||
- 不动 Backend / Frontend / Documents / Dev。
|
||||
- 不引入新数据库表。
|
||||
- 不削弱既有拒绝。
|
||||
- 不修改 created_by 不可变性。
|
||||
- 不破坏现有职责分配、发布流程、版本号。
|
||||
|
||||
**验收条件**：方案 C01-C05、C17、C26-C28 + 既有不退化 + 新表覆盖 canonical identity、project metadata decoupling、author/published filter removal、creator-only management、owner-label-not-authority。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U7
|
||||
- 前置：U2A (RDM 1d9de398) + U2B (RDM 8725ed3)
|
||||
- 后继：U7B sub-unit（perms_api + member_search + doc_visibility + cockpit + plugins/rdm + body-level 共享测试）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U7 拆分决定 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | U7 cursor 3/3 fail-stop 收据 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD2/KTD5/KTD6/KTD8/KTD10 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | RDM `a00466fb` (transport `cc68d698…/4b4d8a620021`) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success，8 文件改动全在 allowed_paths |
|
||||
| 正式测试与验收 | RDM `a00466fb` SELF | PASS | host | 2026-10-19 | `make evidence` exit=0，projects + rdmapp + dhffidelity + dhfmatrix 全 ok |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | RDM L1 transport apply 已完成；待 host 后续 bump Dev `modules/rdm` gitlink |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 1c01763 | 1c01763 | 2026-10-19T07:50:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u7a | RDM `internal/projects/*` + `internal/rdmapp/{project_resource_authz,system_projects,projects_api,*_test,member_guards_test,project_creator_permissions_test,host_projection_test,dhf_template_instance_test,e2e_test}.go` + `pins/{agent-system-backend,agent-system-core,agent-document-renderer}` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/cc68d698…/4b4d8a620021 → RDM commit a00466fbac4b2bc80d6bfee3831d4187be76c248 | 否 | /tmp/iam-link-u7a-run.json (run_id cc68d698… attempt 1) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U7A 实施成功。RDM L1 子分支 `feature/iam-link-u2-single-role-authority` @ `a00466fb` 已推送（Agent-System-RDM origin）；与 U2A（`1d9de39`）+ U2B（`8725ed3f`）累积。8 文件改动 643+/56-，分布：
|
||||
- `internal/projects/projects.go` +32（项目身份唯一性强化）
|
||||
- `internal/projects/projects_test.go` +114（新表）
|
||||
- `internal/rdmapp/project_resource_authz.go` 95+/-（解耦 `perms.ActDocRead` 与 `publishedKnowledgeSource`，改为成员关系判断）
|
||||
- `internal/rdmapp/project_resource_authz_test.go` +145（新表覆盖 author/published filter removed）
|
||||
- `internal/rdmapp/project_creator_permissions_test.go` +180（既有 + 新表覆盖 creator-only management / owner-label-not-authority）
|
||||
- `internal/rdmapp/projects_api.go` +38（项目元数据路径接入）
|
||||
- `internal/rdmapp/system_projects.go` +12（ListSystemProjects / verifyPhysicalProject 解耦 doc.read）
|
||||
- `internal/rdmapp/system_projects_test.go` +83
|
||||
- 验证：PASS
|
||||
- `internal/projects`：ok（含新表）
|
||||
- `internal/rdmapp`：ok（78.7s，含既有 + 新表）
|
||||
- `internal/rdmapp/dhffidelity` / `dhfmatrix`：ok
|
||||
- `go vet ./internal/...` exit=0；`git diff --check` exit=0
|
||||
- 影响与剩余项：
|
||||
- U7B 子单元（`perms_api.go`、`member_search.go`、`doc_visibility.go`、`cockpit.go`、`accountdir*`、`plugins/rdm/*` + body-level 共享测试）尚未派发，依赖 U7A 的 `project_resource_authz` 解耦稳定
|
||||
- 独立 Review 待 fresh session `--role review`（同时覆盖 U2A+U2B+U7A）
|
||||
- Dev `modules/rdm` gitlink bump + RDM L1→main 合入待 host 后续
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+97
@@ -0,0 +1,97 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u7b-a-perms-and-member-search 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：a653d86；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U7B 拆分后第一个子单元 U7B-A；目标 RDM `internal/rdmapp/{perms_api,member_search,accountdir*,*_test,private_doc_views_test,resource_authz_test}.go`；不开 PR、不入 main；不动 U7B-B / U7B-C / U7C / U7A 路径。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`；U7B 父任务卡见 `.task/feature-iam-role-permission-linked-capabilities-u7b-two-trees-and-plugins.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：让 `AuthorizeDocRead` / `AuthorizeCmd` / `sectionBodyReadable` 在有效成员路径下不再以 `doc.read` 为前置；`member_search` 通过成员关系即可读取项目元数据；新成员加入/对话走 `ProjectLifecycle.Work`。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 `project_resource_authz*`、`system_projects*`、`projects_api*`、`cockpit`、`doc_visibility`、`render_submission`、`queued_publication_revocation_test`、`draft_visibility_test`、`iam_i1_*`、`host_projection_test`、`dhf_template_instance_test`、`e2e_test`、`knowledge_publication_test`、`member_guards_test`、`project_creator_permissions_test`、plugins/rdm（U7A / U7B-B / U7B-C / U7C）。
|
||||
- 不动 Backend / Frontend / Documents / Dev。
|
||||
- 不引入新数据库表。
|
||||
- 不削弱既有拒绝。
|
||||
- 不修改 created_by 不可变性。
|
||||
|
||||
**验收条件**：方案 C11/C16/C17 部分 + 既有不退化 + 新表覆盖 member metadata read、member shared read、author/published filter removed、member conversation work。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U7
|
||||
- 前置：U2A + U2B + U7A 均已完成（RDM 1d9de39 + 8725ed3 + a00466fb）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U7B 拆分决定 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | U7B cursor 3/3 fail-stop 收据 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD2/KTD5/KTD6/KTD8/KTD10 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | RDM `cff0e44a` (transport `8b5e9882…/8896fcf86560`) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success，4 文件改动全在 allowed_paths |
|
||||
| 正式测试与验收 | RDM `cff0e44a` SELF | PASS | host | 2026-10-19 | `make evidence` exit=0，rdmapp + projects + plugins/rdm 全 ok |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | RDM L1 transport apply 已完成；待 host 后续 bump Dev `modules/rdm` gitlink |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | a653d86 | a653d86 | 2026-10-19T09:35:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u7b-a | RDM `internal/rdmapp/{perms_api,member_search,accountdir*,*_test,private_doc_views_test,resource_authz_test}.go` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/8b5e9882…/8896fcf86560 → RDM commit cff0e44a7d7c2e9fc993839d64126d2e87c36087 | 否 | /tmp/iam-link-u7b-a-run.json (run_id 8b5e9882… attempt 1) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U7B-A 实施成功。RDM L1 子分支 `feature/iam-link-u2-single-role-authority` @ `cff0e44a` 已推送（Agent-System-RDM origin）；与 U2A + U2B + U7A 累积。4 文件改动 329+/8-，分布：
|
||||
- `internal/rdmapp/perms_api.go` +39（`AuthorizeDocRead` / `AuthorizeCmd` / `sectionBodyReadable` 不再以 doc.read 为前置）
|
||||
- `internal/rdmapp/perms_test.go` +154（新表覆盖 member metadata read / member shared read / author filter removed / published filter removed / member conversation work）
|
||||
- `internal/rdmapp/member_search.go` +55（member metadata 路径接入）
|
||||
- `internal/rdmapp/member_search_test.go` +89
|
||||
- 验证：PASS
|
||||
- `internal/rdmapp`：ok（79.3s，含既有 + 新表）
|
||||
- `internal/projects`：ok（0.2s）
|
||||
- `plugins/rdm`：ok（3.0s）
|
||||
- `go vet ./internal/... ./plugins/...` exit=0；`git diff --check` exit=0
|
||||
- 影响与剩余项：
|
||||
- U7B-B（`doc_visibility/cockpit/render_submission/queued_*` + body-level 共享测试）尚未派发
|
||||
- U7B-C（`plugins/rdm/*` 全套测试）尚未派发
|
||||
- U7C（knowledge/doc shared reads）尚未派发
|
||||
- 独立 Review 待 fresh session `--role review`（同时覆盖 U2A + U2B + U7A + U7B-A）
|
||||
- Dev `modules/rdm` gitlink bump + RDM L1→main 合入待 host 后续
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+101
@@ -0,0 +1,101 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u7b-b-doc-visibility-cockpit-body 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：7753d9a；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U7B 拆分后第二个子单元 U7B-B；目标 RDM `internal/rdmapp/{doc_visibility,cockpit,render_submission,private_doc_views_test,resource_authz_test,queued_publication_revocation_test,draft_visibility_test,knowledge_publication_test,*_test}.go`；不开 PR、不入 main；不动 U7A / U7B-A / U7B-C / U7C 路径。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`；U7B 父任务卡见 `.task/feature-iam-role-permission-linked-capabilities-u7b-two-trees-and-plugins.md`；U7B-A 见 `.task/feature-iam-role-permission-linked-capabilities-u7b-a-perms-and-member-search.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：让 `doc_visibility.go` / `cockpit.go` 的 `AuthorizeDocRead/AuthorizeDocReadScoped/sectionBodyReadable/evalPerm` 在有效成员路径下不再以 `doc.read` 为前置；body 内容对项目成员无 author/duty-author/stage-range 过滤；`render_submission.go` 走 member 鉴权；保留私域边界。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 `perms_api`、`member_search`、`accountdir*`、`project_resource_authz*`、`system_projects*`、`projects_api*`、`iam_i1_*`、`host_projection_test`、`dhf_template_instance_test`、`e2e_test`、`accountdir*`、`member_guards_test`、`project_creator_permissions_test`、plugins/rdm（U7A / U7B-A / U7B-C / U7C）。
|
||||
- 不动 Backend / Frontend / Documents / Dev。
|
||||
- 不引入新数据库表。
|
||||
- 不削弱既有拒绝。
|
||||
- 不修改 created_by 不可变性。
|
||||
|
||||
**验收条件**：方案 C11/C17 部分 + 既有不退化 + 新表覆盖 body-level 共享、author/published/stage/duty-author filter removal、revocation/draft visibility、shared knowledge member reads。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U7
|
||||
- 前置：U2A + U2B + U7A + U7B-A 均已完成（RDM 1d9de39 + 8725ed3 + a00466fb + cff0e44a）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U7B 拆分决定 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | U7A + U7B-A 成功结果 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD2/KTD5/KTD6/KTD8/KTD10 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | RDM `83dd244c` (transport `925ae274…/c8536afce513`) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success，11 文件改动全在 allowed_paths |
|
||||
| 正式测试与验收 | RDM `83dd244c` SELF | 部分 PASS | host | 2026-10-19 | `make evidence` exit=0；rdmapp + projects + plugins/rdm 存在 4 项 plugin 测试失败（`TestAuditReaderSeesRuleOptionsBindingsAndTraceMetadataWithoutBody`、`TestU1DocumentExportUsesContentPermission`、`TestDocReadHonorsStageRange` 等），属 U7B-C 修复范围 |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | RDM L1 transport apply 已完成；待 host 后续 bump Dev `modules/rdm` gitlink（需先完成 U7B-C 修复 plugin 测试） |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 7753d9a | 7753d9a | 2026-10-19T10:00:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u7b-b | RDM `internal/rdmapp/{doc_visibility,cockpit,render_submission,private_doc_views_test,resource_authz_test,queued_publication_revocation_test,draft_visibility_test,knowledge_publication_test,perms_api,member_search_test,*_test}.go` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/925ae274…/c8536afce513 → RDM commit 83dd244c5b476d9a9e719ec6d18dd615f7822329 | 否 | /tmp/iam-link-u7b-b-run.json (run_id 925ae274… attempt 1) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U7B-B 实施成功（attempt 1 scope-expansion → attempt 2 success）。RDM L1 子分支 `feature/iam-link-u2-single-role-authority` @ `83dd244c` 已推送。11 文件改动 792+/254-，分布：
|
||||
- `internal/rdmapp/cockpit.go` +227/-（AuthorizeDocRead/AuthorizeDocReadScoped 解耦 doc.read + body-level 共享读取）
|
||||
- `internal/rdmapp/cockpit_test.go` +184（新表）
|
||||
- `internal/rdmapp/doc_visibility.go` +73（doc_visibility 解耦）
|
||||
- `internal/rdmapp/doc_visibility_test.go` +167（新表）
|
||||
- `internal/rdmapp/draft_visibility_test.go` +67（draft 阶段读取不再以 doc.read 为前置）
|
||||
- `internal/rdmapp/knowledge_publication_test.go` +99（知识发布与撤回 + 共享读取）
|
||||
- `internal/rdmapp/member_search_test.go` +11（member_search_test 113-115 修复）
|
||||
- `internal/rdmapp/perms_api.go` +45（AuthorizeDocReadScoped 解耦 doc.read + read-stage range）
|
||||
- `internal/rdmapp/private_doc_views_test.go` +60（私域共享读取）
|
||||
- `internal/rdmapp/queued_publication_revocation_test.go` +64（撤回判定不阻断共享成员读取）
|
||||
- `internal/rdmapp/resource_authz_test.go` +49（resource authz 表）
|
||||
- 验证：部分 PASS
|
||||
- `internal/rdmapp`：ok（含 U7A + U7B-A + U7B-B 既有 + 新表）
|
||||
- `internal/projects`：ok
|
||||
- `plugins/rdm`：FAIL（4 项 plugin 测试预期失败：audit-only、u1_surface、write_duty_stage、reg_citation）；这些是 U7B-C 范围
|
||||
- 影响与剩余项：
|
||||
- U7B-C（`plugins/rdm/*`）尚未派发；这是恢复 plugin 测试的下一单元
|
||||
- 独立 Review 待 fresh session `--role review`（同时覆盖 U2A + U2B + U7A + U7B-A + U7B-B）
|
||||
- Dev `modules/rdm` gitlink bump 需等 U7B-C 修复后再执行
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+101
@@ -0,0 +1,101 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u7b-c-plugins-rdm-tests 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：3900482；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U7B 拆分后第三个子单元 U7B-C；目标 `plugins/rdm/*`；不开 PR、不入 main；不动 U7A / U7B-A / U7B-B / U7C 路径。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`；U7B 父任务卡见 `.task/feature-iam-role-permission-linked-capabilities-u7b-two-trees-and-plugins.md`；U7B-B 见 `.task/feature-iam-role-permission-linked-capabilities-u7b-b-doc-visibility-cockpit-body.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：让 `plugins/rdm/*` 测试与 U7B-B 解耦后的 body-level 共享规则一致；`TestAuditReaderSeesRuleOptionsBindingsAndTraceMetadataWithoutBody`、`TestU1DocumentExportUsesContentPermission`、`TestDocReadHonorsStageRange` 等 4 项预期失败测试全部 PASS；私有性边界保留。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 `internal/rdmapp/*`、`internal/projects/*`（U7A / U7B-A / U7B-B / U7C 已完成）。
|
||||
- 不动 Backend / Frontend / Documents / Dev。
|
||||
- 不引入新数据库表。
|
||||
- 不削弱既有拒绝。
|
||||
- 不修改 created_by 不可变性。
|
||||
|
||||
**验收条件**：方案 C11/C17 部分 + 既有不退化 + 4 项 U7B-B-broken 测试 PASS + 新表覆盖 body-level 共享成员读、私域附件、阶段读取、引用检索。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U7
|
||||
- 前置：U2A + U2B + U7A + U7B-A + U7B-B 均已完成（RDM 1d9de39 + 8725ed3 + a00466fb + cff0e44a + 83dd244c）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U7B 拆分决定 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | U7B-B 引入 plugins/rdm 4 项预期失败测试 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD2/KTD5/KTD6/KTD8/KTD10 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | RDM `d8cfc707` (transport `925ae274…/c8536afce513` 与 `4b8…` 等) | 已完成 | cursor-agent-stable | 2026-10-19 | `scripts/agent-exec run` terminal_status=success，9 文件改动全在 allowed_paths |
|
||||
| 正式测试与验收 | RDM `d8cfc707` SELF | PASS | host | 2026-10-19 | `make evidence` exit=0，rdmapp + projects + plugins/rdm 全 ok；U7B-B 引入的 4 项 plugins/rdm 失败测试全部修复 |
|
||||
| 代码 Review | 待独立会话 | 待执行 | — | — | fresh session, `--role review` |
|
||||
| 合入 | 待 host | 待执行 | — | — | RDM L1 transport apply 已完成；待 host 后续 bump Dev `modules/rdm` gitlink |
|
||||
| 合入核验与收口 | 待 host | 待执行 | — | — | L1 PR #628 base gate |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 3900482 | 3900482 | 2026-10-19T10:40:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u7b-c | `plugins/rdm/*` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1 | cursor-agent-stable 2026.10.14-0f9edde | completed (success) | refs/agent-exec/…/c8536afce513 → RDM commit d8cfc70725f0275617cb44a8112b0fdf999de08a | 否 | /tmp/iam-link-u7b-c-run.json (run_id 4b8… attempt 1) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：U7B-C 实施成功。RDM L1 子分支 `feature/iam-link-u2-single-role-authority` @ `d8cfc707` 已推送。9 文件改动 208+/82-，分布：
|
||||
- `plugins/rdm/plugin.go` +59（plugin 总入口改造）
|
||||
- `plugins/rdm/render_audit_metadata_test.go` +18
|
||||
- `plugins/rdm/u1_surface_test.go` +22
|
||||
- `plugins/rdm/iam_i1_authorization_test.go` +29
|
||||
- `plugins/rdm/write_duty_stage_test.go` +31
|
||||
- `plugins/rdm/private_body_exports_test.go` +38
|
||||
- `plugins/rdm/private_inspection_test.go` +47
|
||||
- `plugins/rdm/reg_citation_test.go` +17
|
||||
- `plugins/rdm/draft_visibility_test.go` +29
|
||||
- 验证：PASS
|
||||
- `internal/rdmapp`：ok（77.7s）
|
||||
- `internal/projects`：ok
|
||||
- `plugins/rdm`：ok（2.7s；4 项 U7B-B-broken 测试全部修复）
|
||||
- `go vet ./internal/... ./plugins/...` exit=0；`git diff --check` exit=0
|
||||
- 影响与剩余项：
|
||||
- U7 拆分子单元全部完成（U7A + U7B-A + U7B-B + U7B-C）
|
||||
- U7C（knowledge/doc shared reads）尚未派发；可与 U7 完成合并考虑
|
||||
- 独立 Review 待 fresh session `--role review`（同时覆盖 U2A + U2B + U7A + U7B-A + U7B-B + U7B-C）
|
||||
- Dev `modules/rdm` gitlink bump + RDM L1→main 合入待 host 后续
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
+92
@@ -0,0 +1,92 @@
|
||||
# feature/iam-role-permission-linked-capabilities-u7b-two-trees-and-plugins 任务卡
|
||||
|
||||
任务主记录：<PR 链接，交付前填写>；状态：进行中；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：child；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：feature/iam-role-permission-linked-capabilities；accepting_requirements：false；parent_branch：feature/iam-role-permission-linked-capabilities；parent_head_sha：251536d；parent_pr：PR #628
|
||||
|
||||
- 授权与交付终点：U7 拆分后第二个子单元 U7B；目标 RDM `internal/rdmapp/{perms_api,member_search,accountdir*,doc_visibility,cockpit,private_doc_views_test,resource_authz_test,queued_publication_revocation_test,draft_visibility_test,iam_i1_*,host_projection_test,dhf_template_instance_test,e2e_test,knowledge_publication_test,*_test}.go` + `plugins/rdm/{plugin,system_projects,register_v2,iam_i1_*,resource_authz,draft_*,member_*,perm_*,roles,account_directory,duty_*,host_projection,private_*,reg_*,render_audit,u1_surface,write_duty_stage,*_test}.go`；不开 PR、不入 main；不动 U7A 路径（projects/* + project_resource_authz + system_projects + projects_api + member_guards_test + project_creator_permissions_test）。
|
||||
- 交付模式：goal-first
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 当前阶段：实施单元已登记，待 agent 派发
|
||||
- 流程依据：仓库根目录 policy/delivery.md；父 L1 charter 见 `.task/feature-iam-role-permission-linked-capabilities.md`；U7 父任务卡见 `.task/feature-iam-role-permission-linked-capabilities-u7-canonical-two-trees.md`；U7A 见 `.task/feature-iam-role-permission-linked-capabilities-u7a-canonical-project-identity.md`
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
**目标**：让所有有效成员读同一份两树一网共享内容（body-level 与 metadata 一致），无 author/role/publication/duty-author/stage-range 过滤；新增成员加入走 `ProjectLifecycle.Work`（U7A 已建立 `project_resource_authz` 解耦基础）。
|
||||
|
||||
**范围**：见单元包 allowed_paths。
|
||||
|
||||
**非目标**：
|
||||
- 不动 `internal/projects/*`、`internal/rdmapp/{project_resource_authz*,system_projects.go,projects_api.go,member_guards_test.go,project_creator_permissions_test.go}`（U7A 已完成）。
|
||||
- 不动 Backend / Frontend / Documents / Dev。
|
||||
- 不引入新数据库表。
|
||||
- 不削弱既有拒绝。
|
||||
- 不修改 created_by 不可变性。
|
||||
|
||||
**验收条件**：方案 C11-C17、C26-C31 + 既有不退化 + 新表覆盖 body-level 共享、member conversation work、author/published/stage/duty-author filter removal。
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 主记录：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md` U7
|
||||
- 前置：U2A + U2B + U7A 均已完成（RDM 1d9de39 + 8725ed3 + a00466fb）
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 本卡 | 已完成 | host | 2026-10-19 | U7 拆分决定 |
|
||||
| 需求评估 | 本卡 | 已完成 | host | 2026-10-19 | U7 cursor 3/3 fail-stop + U7A 成功结果 |
|
||||
| 需求表确认 | 本卡 | 已完成 | host | 2026-10-19 | 范围 |
|
||||
| 方案设计 | 单元包 JSON | 已完成 | host | 2026-10-19 | KTD2/KTD5/KTD6/KTD8/KTD10 |
|
||||
| 实施计划 | 单元包 JSON | 已完成 | host | 2026-10-19 | allowed_paths/verification/timeout_seconds |
|
||||
| 实施与自检 | cursor-agent attempt 1 (failed-unknown) + attempt 2 (scope-expansion) + attempt 3 (failed-unknown) | 三试全 fail-stop，cursor 候选耗尽 | cursor-agent | 2026-10-19 | attempt 1 15 文件 437+/220- 改动完成但 worker 终态记录格式无效；attempt 2 列需要 `project_resource_authz.go`、`project_resource_authz_test.go`、`system_projects_test.go`、`render_submission.go` 等 U7A 路径；attempt 3 按 attempt 2 列表扩到 53 路径含全部 production + test + plugin，仍以 failed-unknown 结束（26 文件 650+/284- 改动完成） |
|
||||
| 正式测试与验收 | NOT_RUN | | | | 本会话不再尝试 |
|
||||
| 代码 Review | NOT_RUN | | | | |
|
||||
| 合入 | NOT_RUN | | | | 后续会话修订 U7B 单元包或拆分 |
|
||||
| 合入核验与收口 | NOT_RUN | | | | |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 251536d | 251536d | 2026-10-19T08:25:00Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| iam-link-u7b | RDM `internal/rdmapp/{perms_api,member_search,accountdir*,doc_visibility,cockpit,private_*,queued_*,draft_*,iam_i1_*,host_projection_test,dhf_*,e2e_test,knowledge_publication,project_resource_authz*,system_projects_test,render_submission,*_test}.go` + `plugins/rdm/*` | AGENT-EXECUTION.md digest=bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c | implementation | [cursor, antigravity, pi] | 1+2+3 | cursor-agent-stable 2026.10.14-0f9edde | attempt 1=failed-unknown, attempt 2=scope-expansion, attempt 3=failed-unknown；cursor 候选耗尽 | 无 | 否 | /tmp/iam-link-u7b-run.json (run_id db0eb5d3… + 8f9c5b8d… + 5b0d2c9b…) |
|
||||
|
||||
## 结果与验证（完成后填写）
|
||||
|
||||
- 结果：cursor 三次尝试均 fail-stop，未产生可应用 transport；cursor 候选耗尽（3/3）。
|
||||
- attempt 1 (run_id=db0eb5d3…) terminal=failed-unknown；worktree 15 文件 437+/220- 改动。
|
||||
- attempt 2 (run_id=8f9c5b8d…) terminal=scope-expansion；agent 列真实需要扩 `internal/rdmapp/{project_resource_authz,project_resource_authz_test,system_projects_test,render_submission}.go`，因 U7A 未删 `project_resource_authz.go` knowledge 分支的 `publishedKnowledgeSource` 过滤，且 `system_projects_test.go` / `project_resource_authz_test.go` 仍以 doc.read 为前置。
|
||||
- attempt 3 (run_id=5b0d2c9b…) terminal=failed-unknown；按 attempt 2 列表扩 allowed_paths 到 53，仍以 failed-unknown 结束；worktree 26 文件 650+/284- 改动完成（含 `project_resource_authz.go` 删 publishedKnowledgeSource + `render_submission.go` 入 member 鉴权）。
|
||||
- 验证：NOT_RUN（cursor 候选耗尽无成功 transport）
|
||||
- 影响与剩余项：
|
||||
- cursor 候选已耗尽（3/3），未启 codex 紧急（按 `policy/delivery.md` 显式 fail-stop 规则）。
|
||||
- 后续会话建议：
|
||||
1. 改派 agy（违反"不换候选"但实际是重启 cursor 已死的单元）；新工作区独立判断
|
||||
2. 拆 U7B 为更小单元：`internal/rdmapp/perms_api.go` + `member_search.go` 子单元 A；`doc_visibility.go` + `cockpit.go` 子单元 B；`plugins/rdm/*` + body-level 测试 子单元 C
|
||||
- U7C 子单元（已规划但尚未登记到 L1）与 U7B 合并考虑
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN
|
||||
- 冲突记录：NOT_RUN
|
||||
- CI 记录：NOT_RUN
|
||||
- 合入记录：NOT_RUN
|
||||
- 清理记录：NOT_RUN
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
@@ -0,0 +1,225 @@
|
||||
# feature/iam-role-permission-linked-capabilities 任务卡
|
||||
|
||||
任务主记录：PR #628 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/628；状态：已完成（回填）；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed
|
||||
- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-iam-role-permission-linked-capabilities（worktree）；分支：feature/iam-role-permission-linked-capabilities
|
||||
- 分支类型：initiative；initiative_id：feature-iam-role-permission-linked-capabilities；root_target：main；immediate_target：main；accepting_requirements：true
|
||||
- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=62e8104b014777e84799e26eaaa1d9fdccf4f934271964317420c0e3d39e6a11；triage_receipt=/tmp/iam-perm-triage-20261019.json；receipt_sha256=8487aa0d0cf79d9f0ef5e5c1fd92f4f28ad530c4276ccc044d29d7b1633b92e6
|
||||
|
||||
- 授权与交付终点：<本次允许的动作与终点；未授权事项写明>
|
||||
- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）
|
||||
- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）
|
||||
- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收
|
||||
- 当前阶段：需求拆解；当前增量：I1（待定义）
|
||||
- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）
|
||||
|
||||
## 目标与非目标
|
||||
|
||||
### 章程（charter）
|
||||
|
||||
**用途与目标**：按方案 revision 3 实现「项目协作与联动权限」：全局同名业务项目唯一且所有成员共用同一规范 `projectId`；创建者能管理本人项目并加成员；有效成员自动看到同一项目并能创建本人私有对话、收发消息；同一项目两树一网（笔记树/文档树/追溯网）由有效成员关系派生完整共享读取；编辑/编制/审核/批准/发布按角色与文档职责分别判定。修复方案"Problem Frame"列出的 403 根因（隐藏管理 cap 依赖）与 ProjectMembers/ProjectMetadata 仍以 `doc.read` 为前置的耦合。
|
||||
|
||||
**接纳范围**（与方案 R1-R17 对齐）：
|
||||
- R1-R9：角色/账号/绑定稳定性、系统范围创建能力、联动管理资格、单一角色权威、Backend/RDM 公开提供者复用、解释/保存同源、失效与拒绝语义、迁移稳定。
|
||||
- R10-R12, R14-R15, R17：全局同名项目、不可变创建者、成员基础协作、完整两树一网共享读取、自动发现 5s 内可见。
|
||||
- R13, R16：成员加入不打断工作、关联权限不存断链。
|
||||
- 对应单元：**U1 业务能力联动（Backend）**→ **U2 单一角色权威（Backend+RDM）** → **U7 同项目两树一网完全共享（RDM+Backend）** → **U3 能力暴露与解释（Backend+RDM）** → **U4 Frontend 自动发现与联动配置** → **U5 测试与组合（Backend+RDM+Frontend）** → **U6 交付合入（host 主导）**。
|
||||
- C01-C31：见方案 Verification Contract；本卡验收以此为准，未执行时均为 NOT_RUN。
|
||||
|
||||
**非目标**：
|
||||
- 账号恢复、多职位角色、Agent 权限、新工作流、生产迁移与部署、版本发布、跨实例分布式演进、生成式 UI、DHF 模板、文档生成管线（均属既有方向，已各有独立提案/任务；不在本 L1 范围）。
|
||||
- 既有 IAM U4 单角色与 U3 账号目录已合入 main 的部分不复用做修改；只在其基础上叠加业务能力联动与共享读取。
|
||||
- `feature/iam-role-project-design`（R0=3fb8210，落后 52 提交、范围与本方案不重叠）作废，不作为本 L1 子分支。
|
||||
|
||||
**分级测试策略**：
|
||||
- 单元→L2（child → L1）：worker 自检 + host 最小直接检查（`make test-affected`）+ 全新会话独立 Review；轻量 CI（GATE 仅 PR base 非 main 时跳过 `test-pg`/`svc-realcombo`）。
|
||||
- L1 → main：完整 CI（`test`/`test-pg`/`svc-realcombo`）#518 窗口，三段证据（precheck/task-sync/test），合入前 `make task-close SELF=1` 闭合。
|
||||
- 浏览器/双账号闭环验证 C11-C16、C19-C21、C26-C30：U5 阶段在 U4 完成后跑真实 Playwright + RDM acceptance 脚本。
|
||||
|
||||
**验收条件**：C01-C31 全部 PASS；本机 dev 实例复现原 403 已不再发生；完整双账号证据（创建→加成员→被加者登录页自动出现→本人对话收发→移除后失效）。
|
||||
|
||||
**追加领域规则**：
|
||||
- 任何新代码不得绕过 `RolePolicyProvider`/`SystemActionProvider` 直接调用 `AccountRoleOf`/`RoleActionOf`（U2 修复点）。
|
||||
- 任何读写面不得以 `doc.read=true` 为前置判断"成员是否能看到项目元数据"（U7 解耦点）。
|
||||
- 任何项目内共享节点/文档/事件不得以作者、职位、发布状态、审签职责资格过滤（U7+R14 共享语义）。
|
||||
- 关联配置缺失或显式冲突必须整笔失败，不得静默允许 create 但管理断链（U1+R3）。
|
||||
- 移除/失效后服务端立即拒绝后续写，旧流重验并停止，前台 5s 内同步（U7+U4）。
|
||||
|
||||
**生命周期**：建立即开本 PR 作 [WIP] 占位；接收子任务登记；最终一次性合入 main，闭合 `.task/`、归档、回收 worktree；不接受长期 develop 分支。
|
||||
|
||||
**关联方向与规划**：
|
||||
- 主记录：方案 revision 3（路径 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md`，2026-10-19；review-v2.md 两次独立只读审阅已记录）。
|
||||
- 既有同向提案：`modules/documents/docs/proposals/2026-10-13-system-project-membership.md`（项目身份与成员入口）、`2026-10-15-iam-focused-role-permission-spec.md`（聚焦范围 R1-R6；本 L1 不重做）。
|
||||
|
||||
## 子任务登记
|
||||
|
||||
| 子任务分支 | 必需 | 状态 | PR | 单元 | 范围摘要 |
|
||||
|---|---|---|---|---|---|
|
||||
| feature/iam-role-permission-linked-capabilities-u1-capability-association | 是 | 已完成（Backend 子分支 afb65c5 推送，Dev gitlink bump 待 host；独立 Review 待 fresh session） | —（child 不开 PR） | U1 | Backend `internal/authz/catalog`、`internal/store/role_policy`、公开扩展 DTO；RDM `internal/perms/role_provider.go` 与创建能力判定；KTD1/KTD3/KTD4；C06/C08/C09/C10 |
|
||||
| feature/iam-role-permission-linked-capabilities-u2-single-role-authority | 是 | 已完成（U2A + U2B 双子单元均 success；RDM L1 子分支 8725ed3 已推远端；待 Dev gitlink bump + 独立 Review） | —（child 不开 PR） | U2 | RDM `perms_api.go`、`system_projects.go`、`plugins/rdm/{system_projects,plugin}.go`；Backend `hostcaps.go`；KTD7；C22 |
|
||||
| feature/iam-role-permission-linked-capabilities-u2a-perms-and-perms-api | 是 | 已完成（RDM L1 子分支 1d9de398 推送，待 Dev gitlink bump + 独立 Review） | —（child 不开 PR） | U2A（U2 拆分） | RDM `internal/perms/*` + `internal/rdmapp/{perms_api,member_search,accountdir*,*_test}.go`；KTD7；U2A 子表 |
|
||||
| feature/iam-role-permission-linked-capabilities-u2b-system-projects-and-plugins | 是 | 已完成（RDM L1 子分支 8725ed3 推送，待 Dev gitlink bump + 独立 Review） | —（child 不开 PR） | U2B（U2 拆分） | RDM `internal/rdmapp/{system_projects,projects_api,project_resource_authz,settings_duties,runtime}` + `plugins/rdm/{plugin,system_projects,*}`；KTD7 |
|
||||
| feature/iam-role-permission-linked-capabilities-u7-canonical-two-trees | 是 | blocked（cursor 3/3 fail-stop；拆分为 U7A + U7B + U7C 重新派发；U7A 已登记卡片待 agent 派发） | —（child 不开 PR） | U7 | RDM `internal/projects/{projects,provisioning,projection_rename}.go`、`internal/rdmapp/{projects_api,system_projects,project_resource_authz}.go`；Backend `internal/server/{project_lifecycle,server}.go`；KTD2/KTD5/KTD6/KTD8/KTD10；C01-C05/C11-C17/C19-C21/C26-C31 |
|
||||
| feature/iam-role-permission-linked-capabilities-u7a-canonical-project-identity | 是 | 已完成（RDM L1 子分支 a00466fb 推送，待 Dev gitlink bump + 独立 Review） | —（child 不开 PR） | U7A（U7 拆分） | RDM `internal/projects/*` + `internal/rdmapp/{project_resource_authz,system_projects,projects_api,*_test,member_guards_test,project_creator_permissions_test,host_projection_test,dhf_template_instance_test,e2e_test}.go`；KTD2/KTD5/KTD6/KTD8/KTD10；C01-C05/C17/C26-C28 |
|
||||
| feature/iam-role-permission-linked-capabilities-u7b-two-trees-and-plugins | 是 | blocked（cursor 3/3 fail-stop；拆分 U7B-A 待派发，U7B-B / U7B-C 待登记） | —（child 不开 PR） | U7B（U7 拆分） | RDM `internal/rdmapp/{perms_api,member_search,accountdir*,doc_visibility,cockpit,*_test}.go` + `plugins/rdm/*`；C11-C17/C26-C31 |
|
||||
| feature/iam-role-permission-linked-capabilities-u7b-a-perms-and-member-search | 是 | 已完成（RDM L1 子分支 cff0e44a 推送，待 Dev gitlink bump + 独立 Review） | —（child 不开 PR） | U7B-A（U7B 拆分） | RDM `internal/rdmapp/{perms_api,member_search,accountdir*,*_test,private_doc_views_test,resource_authz_test}.go` |
|
||||
| feature/iam-role-permission-linked-capabilities-u7b-b-doc-visibility-cockpit-body | 是 | 已完成（RDM L1 子分支 83dd244c 推送；4 项 plugins/rdm 测试预期失败待 U7B-C 修复） | —（child 不开 PR） | U7B-B（U7B 拆分） | RDM `internal/rdmapp/{doc_visibility,cockpit,render_submission,private_doc_views_test,resource_authz_test,queued_publication_revocation_test,draft_visibility_test,knowledge_publication_test,perms_api,member_search_test,*_test}.go` |
|
||||
| feature/iam-role-permission-linked-capabilities-u7b-c-plugins-rdm-tests | 是 | 已完成（RDM L1 子分支 d8cfc707 推送，plugins/rdm 测试全绿） | —（child 不开 PR） | U7B-C（U7B 拆分） | `plugins/rdm/*` |
|
||||
| feature/iam-role-permission-linked-capabilities-u7c-knowledge-and-doc-shared-reads | 是 | 待登记（U7A 完成后） | —（child 不开 PR） | U7C（U7 拆分） | RDM `internal/rdmapp/{private_doc_views_test,resource_authz_test,queued_publication_revocation_test,draft_visibility_test,iam_i1_*,e2e_test,knowledge_publication_test}.go` + 两树一网共享读取 |
|
||||
| feature/iam-role-permission-linked-capabilities-u3-capability-exposure | 是 | 已登记子单元卡片 U3A + U3B | — | U3 | Backend/RDM 解释接口、HTTP/command 错误分类、创建/添加成员/对话失败原因；KTD1/KTD2/KTD6 |
|
||||
| feature/iam-role-permission-linked-capabilities-u3a-backend-capability-explanation | 是 | 已完成（Backend L1 子分支 e942a35b 推送，待 Dev gitlink bump + 独立 Review） | —（child 不开 PR） | U3A（U3 拆分） | Backend `pkg/extension/` + `internal/authz/` + `internal/app/` + `internal/server/` + `internal/store/` |
|
||||
| feature/iam-role-permission-linked-capabilities-u3b-rdm-projectfailure-integration | 是 | 已完成（RDM L1 子分支 b74fc0e8 推送；待 Dev gitlink bump + 独立 Review） | —（child 不开 PR） | U3B（U3 拆分） | RDM `internal/rdmapp/{system_projects,projects_api,perms_api,member_search,perms,project_failure,explain,*_test}.go` + `plugins/rdm/{plugin,*_test}.go` |
|
||||
| feature/iam-role-permission-linked-capabilities-u4-frontend-auto-discover | 是 | 已完成（Frontend L1 子分支 f015798 推送，待 Dev gitlink bump + 独立 Review） | —（child 不开 PR） | U4 | Frontend `RolePermissionsPanel.tsx`、`AccountUsersPanel.tsx`、`adminRdmSections.tsx`、`TaskSidebar.tsx`、`App.tsx`、`store.ts`、`api.ts`、`rolePermissions.ts`、`projectmeta.ts`；KTD9；C13-C15/C19-C21/C23 |
|
||||
| feature/iam-role-permission-linked-capabilities-u5-integration-tests | 是 | 拆 U5-Backend / U5-RDM / U5-Frontend 三个子单元（每仓一个独立 dispatch）；U5-Backend 已登记卡片待派发 | —（child 不开 PR） | U5 | 复用 Backend `project_lifecycle_test.go`/`role_authorization_test.go`、RDM `system_projects_test.go`/`project_creator_permissions_test.go`/`member_guards_test.go`/`role_provider_test.go`、Frontend 角色/成员/项目测试；新增浏览器双账号场景；不搭新测试框架；C01-C31 全集 |
|
||||
| feature/iam-role-permission-linked-capabilities-u5-backend-integration-tests | 是 | 已完成（Backend L1 子分支 1214ad43 推送，待 Dev gitlink bump + 独立 Review） | —（child 不开 PR） | U5-Backend（U5 拆分） | Backend `internal/server/{project_lifecycle_test,role_authorization_test,project_iam_integration_test}.go` |
|
||||
| feature/iam-role-permission-linked-capabilities-u5-rdm-integration-tests | 是 | blocked（cursor 3/3 全 blocked；agent 拒绝修改生产代码以加 test helper） | —（child 不开 PR） | U5-RDM（U5 拆分） | RDM `internal/rdmapp/{system_projects_test,project_creator_permissions_test,member_guards_test,perms_api_test,explain_test,project_failure_test,iam_integration_test}.go` |
|
||||
| feature/iam-role-permission-linked-capabilities-u5-frontend-integration-tests | 是 | blocked（cursor 3/3 全 blocked） | —（child 不开 PR） | U5-Frontend（U5 拆分） | Frontend `src/{store.test,components/{adminRdmSections,RolePermissionsPanel,AccountUsersPanel,TaskSidebar}.test,rolePermissions.test,projectmeta.test}.{ts,tsx}` + `e2e/{two_account_browser.spec,_helpers,playwright.config}.{ts,tsx}` |
|
||||
| feature/iam-role-permission-linked-capabilities-u6-delivery | 否 | 待启动 | — | U6 | host 主导：同步、Review、CI、PR 合入、迁移/部署按单独授权执行；更新相关旧权限/项目规格 |
|
||||
|
||||
## Agent 实施收据
|
||||
|
||||
路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。
|
||||
|
||||
| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 |
|
||||
|---|---|---|---|---|---|---|---|---|---|---|
|
||||
| 待定义 | — | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | — |
|
||||
|
||||
## 关联方向与规划
|
||||
|
||||
- 适用状态：待核对（无适用规划时说明原因）
|
||||
- 主记录路径/版本：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md`（2026-10-19；review-v2.md 两次独立只读审阅）
|
||||
- 对应里程碑：项目身份与成员协作闭环 + 业务能力联动 + 同项目两树一网完全共享
|
||||
|
||||
## 需求分析
|
||||
|
||||
| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| R1 | 待填写 | 待评估 | 待定 | 待定义 | 待确认 | 待评审 |
|
||||
|
||||
## 方案与计划
|
||||
|
||||
- 方案引用：方案 revision 3 `/tmp/iam-role-permission-plan-20261019-sqfu_4g4/plan.md`（R1-R17, KTD1-KTD10, U1-U6, C01-C31）
|
||||
- 实施计划引用：方案 §"Implementation Units" U1-U6 + 本卡 ## 子任务登记 + 子任务各自的卡片
|
||||
- 测试计划引用：方案 §"Verification Contract" C01-C31；分级门禁见仓库根 `policy/delivery.md#层级任务通道与分级门禁`
|
||||
|
||||
## 阶段记录
|
||||
|
||||
| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 |
|
||||
|---|---|---|---|---|---|
|
||||
| 需求拆解 | 待定 | 待执行 | — | — | — |
|
||||
| 需求评估 | 待定 | 待执行 | — | — | — |
|
||||
| 需求表确认 | 待定 | 待执行 | — | — | — |
|
||||
| 方案设计 | 待定 | 待执行 | — | — | — |
|
||||
| 实施计划 | 待定 | 待执行 | — | — | — |
|
||||
| 实施与自检 | 待定 | 待执行 | — | — | — |
|
||||
| 正式测试与验收 | 待定 | 待执行 | — | — | — |
|
||||
| 代码 Review | 待定 | 待执行 | — | — | — |
|
||||
| 合入 | 待定 | 待执行 | — | — | — |
|
||||
| 合入核验与收口 | 待定 | 待执行 | — | — | — |
|
||||
|
||||
## 探索试验与迭代
|
||||
|
||||
| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 |
|
||||
|
||||
## 同步记录
|
||||
|
||||
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|
||||
|---|---|---|---|
|
||||
| 启动 | 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed | 7716b28cfff5200e7cfe9ec75aff5bcd71b234ed | 2026-10-19T02:19:19Z |
|
||||
|
||||
## 证据（Evidence）
|
||||
|
||||
<!-- CMD="<命令>" make evidence 写入；手抄/转写输出视为无效证据（AGENTS.md 证据与验证门禁）。 -->
|
||||
| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
## 交付调度
|
||||
|
||||
- 调度状态：PR #628 已开但 L1→main 合入被 CI 阻止；调度记录：无
|
||||
- entry_id：PR #628 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/628
|
||||
- attempt_id：无
|
||||
- 窗口执行者：未进入 #518 窗口（CI 全量门禁失败）
|
||||
- 固定候选：无（base/head、组件与相关配置引用实际尝试）
|
||||
- 调度依据：policy/delivery.md#合入调度
|
||||
- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合
|
||||
- CI 状态：ci/test（PR base gate 已通过）、ci/test-pg、ci/svc-realcombo 均失败
|
||||
- ci/test 失败原因：Backend `3f4b34a` 预期 `agent-intent=651a2e1 / agent-native=28f3ea7 / agent-squad=11ff3a0 / agent-system-core=0cf0344`，Dev 当前 pin 为 `agent-intent=343b1e6 / agent-native=c348441 / agent-squad=490b0b2 / agent-system-core=1a5ef6b`，pins 不一致
|
||||
- ci/test-pg 失败原因：PostgreSQL+pgvector+Redis 服务未就绪
|
||||
- ci/svc-realcombo 失败原因：SQLite+Redis 服务未就绪
|
||||
|
||||
## 结果与验证
|
||||
|
||||
- 结果：
|
||||
- 验证：<结论摘要 PASS/FAIL/SKIP/NOT_RUN 逐项；逐条证据由 make evidence 写入上方证据表>
|
||||
- 影响与剩余项：
|
||||
|
||||
## 规划进展与下一步
|
||||
|
||||
- 本次推进/剩余：待核对（依据实际成果更新适用方案/规划）
|
||||
- 首选下一任务：待核对（无适用规划、已完成或受阻时如实说明，不虚构任务）
|
||||
- 推荐依据：待填写
|
||||
- 前置条件/待确认：待核对
|
||||
- 预期产物/验收条件：待定义
|
||||
- 重复任务核对：待核对（已有/在途任务、PR 与规划记录）
|
||||
- 启动授权：未授权（建议不自动启动新任务，仍须明确授权）
|
||||
|
||||
## 合入与清理
|
||||
|
||||
- Review 记录：NOT_RUN（审阅智能体/平台身份、base/head、结论、问题闭合及重放依据）
|
||||
- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测）
|
||||
- CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果）
|
||||
- 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验）
|
||||
- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）
|
||||
|
||||
<!-- Local receipt: SELF. Digests detect corruption; they do not authenticate a reviewer or CI. -->
|
||||
```json
|
||||
{
|
||||
"summary_schema": 1,
|
||||
"source": "SELF",
|
||||
"timestamp": "2026-10-19T02:18:03.255518+00:00",
|
||||
"command": "make precheck",
|
||||
"exit_code": 0,
|
||||
"cwd": "/home/weichen/projects/Agent-System-Dev",
|
||||
"before_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"after_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"branch": "main",
|
||||
"target_branch": "main",
|
||||
"target_head": "7716b28cfff5200e7cfe9ec75aff5bcd71b234ed",
|
||||
"root_target": "main",
|
||||
"immediate_target": "main",
|
||||
"before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"output_tail": [
|
||||
"make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev'",
|
||||
"[repo] branch=main head=7716b28cff",
|
||||
"[remote] origin/main=7716b28cff ahead=0 behind=0",
|
||||
"[tree] clean submodules_drift=0 uninit=13",
|
||||
"[warn] 13 个子模块未初始化——构建/测试前需物化（不阻断写入）",
|
||||
"[worktrees] linked=4",
|
||||
"[recycle] merged un-recycled branches: feature/layered-python-env",
|
||||
"[initiatives] local cards (not authoritative): none",
|
||||
"[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）",
|
||||
"[facts] policy/facts.md 6 条事实均在有效期内",
|
||||
"[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md",
|
||||
"[R0] 7716b28cff（完整：7716b28cfff5200e7cfe9ec75aff5bcd71b234ed）",
|
||||
"[worktree] before-sync: recursive component checks passed",
|
||||
"[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch",
|
||||
"make[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev'"
|
||||
],
|
||||
"output_sha256": "00d1d77195cce33daea48c77e35a09b4e92695d9dcd9c53704914f7b9cbe8b26",
|
||||
"receipt_sha256": "8ff8d4dd5f4fe50bf0b779d5de7c989c8eab122babf7bee5ba6237de8640f2af",
|
||||
"receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/8ff8d4dd5f4fe50bf0b779d5de7c989c8eab122babf7bee5ba6237de8640f2af.json"
|
||||
}
|
||||
```
|
||||
|
||||
## 闭合记录（card-autoclose 回填）
|
||||
|
||||
- 依据：merge ac594c90e536cfb670e94680f045a6c8247a2513（PR #643）已包含于 origin/main，分支成果已落盘；本段为合入后回填。
|
||||
- 合并主题：Merge pull request 'IAM L1 → main: capability-association + single-role-authority + capability-exposure + frontend-auto-discover + 7-canonical-two-trees (U1/U2/U3/U4/U7 + U5-Backend)' (#643) from feature/iam-role-permission-linked-capabilities into main
|
||||
- 归档：随闭合移入 .task/archive/；任务执行期的过程证据见原任务记录与 PR。
|
||||
@@ -1,6 +1,7 @@
|
||||
# feature/layered-python-env 任务卡
|
||||
|
||||
状态：实施已落在独立 worktree，未推送、未合入；owner：weichen
|
||||
任务主记录：PR #570 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/570
|
||||
状态：已完成（遗留卡闭合）；owner：weichen
|
||||
|
||||
## 基线与授权
|
||||
|
||||
@@ -27,3 +28,7 @@
|
||||
## 非目标
|
||||
|
||||
不重启正在运行的 8788。不修改方案文件。不把项目角色加入审批人。
|
||||
|
||||
## 闭合记录
|
||||
|
||||
- 2026-10-19：PR #570 已合入 main（merge commit 04acb027f6678d9a7a1fbdd3cdacb105d8fbd3ee；合入说明记载 CI test、test-pg、svc-realcombo 在 9c7fa27 success）。卡片此前未回填，precheck `[recycle]` 报告该分支已合入未回收；本次回填并归档，远端分支经祖先校验后删除。
|
||||
@@ -0,0 +1,130 @@
|
||||
# permux 独立代码审查（Independent Review）— 2026-10-19
|
||||
|
||||
> 审查者：全新会话（未参与实现），按 `.task/feature-iam-role-permission-linked-capabilities-perm-ux.md` 与本审查任务卡执行独立 Read-Only Review。
|
||||
> 审查对象：Dev 子分支 `feature/iam-role-permission-linked-capabilities-perm-ux`（HEAD 234ce30；起始基线 90317d02）；组件 commit `modules/backend @ 4130ad78 = origin/feature/iam-perm-ux-backend`，`modules/frontend @ 46a63f02 = origin/feature/iam-perm-ux-frontend`。
|
||||
> 终态：组合 pin `modules/backend @ 4130ad7 + modules/frontend @ 46a63f0`，6/6 单元（U1–U5 + U6 组合交付）落 Dev 子分支。
|
||||
> 审查范围：组件仓 `origin/main…origin/feature/iam-perm-ux-*` 与 Dev 父仓 `90317d02..HEAD` 的提交范围；只读分析与命令验证，不修改、不暂存、不提交。
|
||||
|
||||
## 结论
|
||||
|
||||
**结论：PASS（附 1 项非阻塞观察、4 项非阻塞建议）**。本任务卡记录的实现范围（permux-U1–U6）符合：
|
||||
- 数据完整性：批量事务原子性、幂等回执、单 epoch、锁序一致；
|
||||
- 验收一致性：C01–C04 / C07–C10 在真实 Backend + 真实 Frontend dist 浏览器活体（8 场景）PASS；C05 / C06 / C11 / C12 / C15 由 store/HTTP 单测覆盖且测试通过；C13 由 L1 U7 交付；C14 由 design-guard + 实现约定 + 窄屏 helper 覆盖；
|
||||
- 权限边界：新增端点门禁与既有 `requireSystemAction` 契约一致；只读预览无副作用；
|
||||
- 设计系统：design-guard 棘轮 7/7 通过（见验证命令 §6.4）；
|
||||
- 测试充分性：阻塞项为零；下列非阻塞项不影响目标交付。
|
||||
|
||||
---
|
||||
|
||||
## 验证命令与结果（仅读、未写）
|
||||
|
||||
| 命令 | 目的 | 结果 |
|
||||
|---|---|---|
|
||||
| `GOWORK=off go test -count=1 ./internal/authz/... ./internal/store ./internal/server -run "Role\|Policy\|Binding\|AccountSearch\|Batch\|CopyAssign\|Members\|Preview\|Catalog\|System"` | Backend 角色/权限/分配/预览/复制/成员/目录 store+server 单测（覆盖 permux-U1/U2/U6 范围与 409/幂等/版本/批上限/复制联动负控） | `ok agent-system-backend/internal/authz/catalog`、`ok agent-system-backend/internal/store 1.325s`、`ok agent-system-backend/internal/server 3.737s` |
|
||||
| `npx vitest run test/design-guard.test.ts` | DESIGN.md §11 棘轮（动效唯一所有者、裸色值、行内字号、`<details>`） | 7/7 PASS，0.127s |
|
||||
| `npx vitest run test/role-permissions.test.ts test/role-permissions-ui.test.ts test/role-members.test.ts test/permission-explanations.test.ts test/account-users-panel.test.ts test/design-guard.test.ts` | Frontend permux-U3/U4/U5 单元测试 + 跨页选择/重放/草稿基线/成员过滤/设计守护 | 53/53 PASS，0.460s |
|
||||
|
||||
注：`make test` 全量未跑（任务卡「范围纪律」要求）；上述过滤后直接检查与实现范围对齐。
|
||||
|
||||
---
|
||||
|
||||
## 重点审查逐项
|
||||
|
||||
### 重点 1 — Backend 批量事务原子性与锁序
|
||||
|
||||
| 子项 | 结论 | 依据 |
|
||||
|---|---|---|
|
||||
| 批量事务原子性（PatchRolePermissionsBatch / AssignUserRolesBatch / CreateRoleCopyAndAssign） | PASS | 三个批量写共用 `policyWriteBatch`，事务内任意错误 `defer tx.Rollback()` 回滚；`PatchRolePermissionsBatch` 通过循环 `patchRolePermissionsTx` 后再统一 `UPDATE authority_state` 推进 epoch，单一幂等回执（`role_policy.go:1078-1095`、`1087-1095`）；`AssignUserRolesBatch` 先遍历所有 item 完成 `checkRoleAssignmentTx` 预校验，再 rebind，最后 `checkCapabilityAssociationTx` + `UPDATE authority_state`（`role_policy.go:1078-1095`、`1086-1109`）；`CreateRoleCopyAndAssign` 三步（source 校验 → patch 插入 → assign 事务）共用同一 tx（`role_policy.go:1335-1398`）。负控：`TestBatchPatchRolePermissionsStaleLimitAndIdempotency` 验证陈旧版本整批不写、批上限 21、角色重复；`TestBatchAssignUserRolesRejectsWholeBatch` 验证陈旧成员/停用用户/缺失用户/停用角色/重复用户/101 人都整批拒绝；`TestCopyAssignRejectsWithoutResidue` 验证名称重复/源陈旧/用户陈旧/无效 override/101 人/缺 `roles.assign` 全部 0 残留；`TestCopyAssignCreatesRoleAndBindsAtomically` 验证成功路径源角色不变、绑定生效、幂等回执。 |
|
||||
| 单次 epoch 推进 | PASS | 所有写路径共用 `UPDATE authority_state SET authority_epoch=epoch+1 WHERE authority_epoch=epoch`，陈旧时 `RowsAffected()!=1` 返回 `ErrRolePolicyVersion` / `ErrConflict`。`TestBatchAssignUserRolesRebindsAndReplays` 断言 `batch.AuthorityEpoch==epoch+1` 且重放不再推进（`role_policy_test.go:1107-1115`）。 |
|
||||
| 幂等回执（同键异 payload 拒绝） | PASS | `replayReceipt` 比较 `operation` + `requestHash`，同键异 payload 返回 `ErrConflict`（`role_policy.go:435-455`）。`TestRolePolicyIdempotencyKeyCannotChangeRequest` 验证 `ReplaceRolePermissions`；`TestBatchAssignUserRolesRebindsAndReplays` 验证批路径；`TestBatchPatchRolePermissionsStaleLimitAndIdempotency` 验证 `batch_patch`。 |
|
||||
| policyWriteBatch 锁序（用户 → authority_state → 角色行） | PASS | `policyWriteBatch` 先 `lockAccountUsers(tx, owners...)`（owner 排序），再 `tx.QueryRow(...authority_state...) FOR UPDATE`（PG）或事务写锁（SQLite），再调 fn（`role_policy.go:240-292`）。`patchRolePermissionsTx` 内 `roleTx(item.RoleID, true)` 取 FOR UPDATE（`role_policy.go:227-237`）。fn 内不再加用户锁，符合"fn must not lock further users, and policyWriteBatch is not reentrant"契约（`role_policy.go:240-243`）。`TestAssignUserRoleConcurrentExpectedVersionAllowsOne` 验证同 actor 不同角色的并发只允许一方成功（`role_policy_test.go:65-99`）。 |
|
||||
| 政策锁后补锁用户 | 不存在 | fn 中所有用户相关写都基于 fn 入参 `targets`（已在 policyWriteBatch 入参时按 owner 序加锁），不再二次锁；`AccountDirectoryRevision` 等读面用独立只读 tx（`role_policy.go:1420-1476`）。 |
|
||||
|
||||
### 重点 2 — patch 模式预览与批量提交语义一致性
|
||||
|
||||
| 子项 | 结论 | 依据 |
|
||||
|---|---|---|
|
||||
| 同一源 merge 函数（preview / commit） | PASS | `previewRolePermissionsTx` 在 `item.Mode=="patch"` 时调用 `mergeRolePermissionPatch(state.roles[role.RoleID], current, next)`（`role_policy.go:718-723`）；`patchRolePermissionsTx` 调用 `mergeRolePermissionPatch(previous.roles[role.RoleID], current, patch)`（`role_policy.go:1250`）；两路径共用同一函数（`role_policy.go:1168-1207`），预览看到的合并结果与提交落库结果一致。 |
|
||||
| replace 路径回归风险 | PASS | Frontend `previewRoleBatch` 固定传 `mode: 'patch'`（`RolePermissionsPanel.tsx:96`），HTTP 预览请求体含 `mode:"patch"`（`api.ts:143-145`）；Frontend 不再以 `replace` 模式走批量事务。replace 模式仍由 `replaceRolePermissions` 单角色端点支持（`roles.go:103-117`、`role_policy.go:470-548`），未受 patch 改动回归。`TestPreviewRolePermissionsReplaceModeKeepsReplaceSemantics` 与 `TestRolePermissionPreviewPatchModeOverHTTP` 显式锁定两条路径语义。 |
|
||||
| 旧项目 settings 关闭迁移文案 | PASS | `projectCreateDisabledPreviewNote` / `projectCreateDisabledNote` 在 disable patch 时给出中文说明（`role_policy.go:611-619`、`1825-1829`），`mergeRolePermissionPatch` 额外把 `current` 中存在但 patch 未列出的联动项加入 `plan.kept`（`role_policy.go:1192-1200`），保证 disable 后的 `KeptLinkedActions` 与 receipt 一致。`TestPreviewRolePermissionsReplaceModeKeepsReplaceSemantics`、`TestCapabilityAssociationDisablingProjectCreateKeepsLinkedRows` 验证。 |
|
||||
|
||||
### 重点 3 — 前端多角色草稿隔离 / 统一保存 / 409 rebase / 跨页选择 / 复制并分配
|
||||
|
||||
| 子项 | 结论 | 依据 |
|
||||
|---|---|---|
|
||||
| 按 roleId 草稿隔离 | PASS | `RoleDraftMap = Record<string, RoleDraft>`（`RolePermissionsPanel.tsx:25-26`）；`editRoleDraft` 仅写 `drafts[role.roleId]`，跨角色互不污染（`RolePermissionsPanel.tsx:74-78`）；`roleCellValue`、`rolePatchEntries` 按 role 独立取基线（`rolePermissions.ts:74-78`、`97-103`）；`dirtyRoles` 仅列出 dirty role。`test/role-permissions.test.ts:79-90` 与 `test/role-permissions-ui.test.ts:44-58` 验证。 |
|
||||
| 统一保存 | PASS | `previewRoleBatch` + `commitRoleBatch` 是唯一写入口（`RolePermissionsPanel.tsx:95-106`）；`confirmSave` 先以 `entries = patchEntries()` 调用，再 `setDrafts` 删除已保存角色（`RolePermissionsPanel.tsx:545-555`）。`TestRolePermissionUI.saves every dirty role through one authoritative preview and one batch commit` 验证两角色 dirty 时只发一次预览与一次提交。 |
|
||||
| 409 rebase（按角色独立重放本地变化） | PASS | `rebaseRoleDrafts` 并行 `getRole(roleId)`，逐角色调用 `rebaseRoleDraft`（`RolePermissionsPanel.tsx:111-121`）；`rebaseRoleDraft` 复制 `serverValues`，仅在本地相对 `baseline` 变化时回放（`rolePermissions.ts:60-71`）。`test/role-permissions.test.ts:44-58` 与 `test/role-permissions-ui.test.ts:87-103` 验证。`rebaseRoleDrafts` 在 409 路径中被调用并设 `setPreview(null)`（`RolePermissionsPanel.tsx:558-563`）。 |
|
||||
| 跨页选择模型（筛选不扩大集合） | PASS | `MemberSelection.ids` 仅来自逐个勾选或 `selectPage`，搜索/状态/翻页均不动 `selection.ids`（`roleMembers.ts:5-30`）。`selectPage(checked=true)` 只追加本页 id，不覆盖；`selectPage(checked=false)` 只移除本页 id，不动其他页。`test/role-members.test.ts:50-62` 显式断言"搜索变化 / 翻页不扩大集合"。 |
|
||||
| 复制并分配（显式命名 + 权限来源） | PASS | `copyAssignRequest` 强制 `name.trim() != ''`、拒绝空 users 列表（`roleMembers.ts:107-115`）；overrides 仅含相对 source 的差异项（`roleMembers.ts:118-130`）；后端 `CreateRoleCopyAndAssign` 同步校验（`role_policy.go:1335-1398`），受保护动作不进副本（`role_policy.go:1395-1404`），新角色与源角色完全独立维护（`TestCopyAssignCreatesRoleAndBindsAtomically`）。权限来源（roleId/roleVersion）由 `source` 字段强制随请求传递且 `expectedRoleVersion` 不匹配返回 `ErrConflict`。 |
|
||||
|
||||
### 重点 4 — 无障碍与设计守护（design-guard 棘轮）
|
||||
|
||||
| 子项 | 结论 | 依据 |
|
||||
|---|---|---|
|
||||
| design-guard.test.ts 7 项 | PASS | `npx vitest run test/design-guard.test.ts` → `Test Files 1 passed (1), Tests 7 passed (7), Duration 127ms`。覆盖：DESIGN.md 宪法在位、动效唯一所有者、styles.css 裸色值基线、分层组件 CSS 裸色值、组件 TSX 裸色值、组件 TSX fontSize 数值字面量、组件 TSX 无 `<details>` 折叠。 |
|
||||
| 新样式是否会破坏棘轮 | PASS | 本次新增样式集中在 `styles.css`（`.rp-` 与 `.au-` 前缀类，见 `styles.css:519-580` 与 `597-601`）。所用色全部来自 `var(--*)` 令牌，字体使用 `var(--fs-ui-*)`，唯一裸色字面量 `#0e1116 / #101826 / #0b1f38 / #dfe4f2`（行 448）属 HEX_BASELINE_STYLES 已登记的登录品牌面板；无 `@keyframes`，新增 transition 仅出现在 styles.css（设计守护本文件豁免）；新 TSX 文件（`RolePermissionsPanel.tsx`、`AccountUsersPanel.tsx`）无裸色字面量、无 fontSize 数值字面量、无 `<details>` 折叠——以 `@ui` Collapsible 替代（`RolePermissionsPanel.tsx` 全文件 `grep "<details" 0 hits`，同上 `AccountUsersPanel.tsx`、`adminRdmSections.tsx`）。 |
|
||||
| 可访问性（焦点、aria、键盘） | PASS（非阻塞观察下补充） | 矩阵表头 `aria-pressed`、分组 `role="region" aria-label="..."`、单元格 `aria-label="角色名 权限名"`、保存栏 `role="region" aria-label="未保存的权限修改"`、离开守卫 `roleDraftLeaveGuard`（`RolePermissionsPanel.tsx:21,425-435`），`AdminZone.tsx:107` 引用并把守卫返回 `false` 当作取消。键盘焦点：保存/收起按钮 `ref={savePermsRef}` 在 `restoreFocus` 中归还到 `savePerms` 或 `status`（`RolePermissionsPanel.tsx:466-475`）。`test/role-permissions-ui.test.ts:105-110` 断言离开守卫列出每个 dirty role 名。 |
|
||||
|
||||
### 重点 5 — 测试充分性 vs 验收场景 C01–C10 / C15
|
||||
|
||||
| 验收场景 | 覆盖位置 | 结论 |
|
||||
|---|---|---|
|
||||
| C01–C02 多角色矩阵编辑（跨分类与搜索保留草稿、一次提交） | `e2e/iam-perm-ux-live.playwright.ts:172-229`（活体真实服务）+ `test/role-permissions.test.ts:44-62` 与 `test/role-permissions-ui.test.ts:61-86`（重放语义） | PASS |
|
||||
| C03 创建联动（开启 project.create 补齐 4 项 /api/me 联动生效） | `e2e/iam-perm-ux-live.playwright.ts:231-265`（含 admin-grant 用户登入 + `linkedCapabilities.projectCreate=true`+ 4 个 actions 断言） | PASS |
|
||||
| C04 断链拒绝（创建项目开启时联动项不允许不可保存） | `e2e/iam-perm-ux-live.playwright.ts:267-303`（含 409 / roleVersion 不变 / permKey 不变断言） | PASS |
|
||||
| C05 / C06 / C11 / C12 关闭未来创建 / 浏览器层迁移 / 收据回放负控 | `TestCapabilityAssociationDisablingProjectCreateKeepsLinkedRows`、`TestCapabilityAssociationRejectsExplicitConflictAtomically`、`TestRolePolicyIdempotencyKeyCannotChangeRequest`、`TestReplaceRolePermissionsIsAtomicAndIdempotent`、`TestBatchPatchRolePermissionsStaleLimitAndIdempotency`、`TestBatchAssignUserRolesRebindsAndReplays` | PASS（store/HTTP 已覆盖，浏览器层未重复） |
|
||||
| C07 同名辨识（按账号辨识） | `e2e/iam-perm-ux-live.playwright.ts:305-331` + `test/role-members.test.ts:38-48` | PASS |
|
||||
| C08 批量分配（两人预览 → 一次提交） | `e2e/iam-perm-ux-live.playwright.ts:333-354` + `TestBatchAssignUserRolesRebindsAndReplays` | PASS |
|
||||
| C09 409 整批不写且保留选择 | `e2e/iam-perm-ux-live.playwright.ts:356-387`（含保留选择 `已选 2 人` + 角色回退断言） | PASS |
|
||||
| C10 复制并分配（独立维护） | `e2e/iam-perm-ux-live.playwright.ts:389-419`（含源 roleVersion/permKey 不变、bindingCount-1） | PASS |
|
||||
| C13 成员共享读取 / C16 日常实例采用 | 依赖 L1 U7；C16 未授权部署 → 任务卡 NOT_RUN | 非阻塞，按任务卡记录处置 |
|
||||
| C14 键盘/读屏人工走查 | 由 design-guard + 实现约定 + 窄屏 helper 单测覆盖；人工走查未执行 | 非阻塞，按任务卡 NOT_RUN 处置 |
|
||||
| C15 幂等 / 超额负控 | `TestBatchAssignUserRolesRejectsWholeBatch`（101 人、停用、缺失、停用角色、重复用户）、`TestCopyAssignRejectsWithoutResidue`（101 人、缺 `roles.assign` 等） | PASS |
|
||||
|
||||
无负控缺失阻塞项。
|
||||
|
||||
### 重点 6 — 安全与权限边界
|
||||
|
||||
| 子项 | 结论 | 依据 |
|
||||
|---|---|---|
|
||||
| 新增端点门禁（view / manage / assign） | PASS | `roles.go:130`（`POST /api/admin/roles/permissions/preview`）→ `system.permissions.view`；`roles.go:156`（`POST /api/admin/roles/permissions/batch`）→ `system.permissions.manage`；`roles.go:200`（`POST /api/admin/users/role-assignments`）→ `system.roles.assign`；`roles.go:217-223`（`POST /api/admin/users/role-assignments/preview`）→ `system.users.view` AND `system.roles.view`；`roles.go:240-249`（`POST /api/admin/roles/copy-assign`）→ 三动作全部 `system.roles.manage` + `system.permissions.manage` + `system.roles.assign`；`account_search.go:248-263`（`GET /api/admin/roles/{roleId}/members`）→ `system.users.view` AND `system.roles.view`。HTTP 层 `requireSystemAction` → store 层 `requireSystemActionTx`（同一 tx 内重新判定）`role_policy.go:1692-1720`，与既有 requireSystemAction 契约一致。`TestSystemUserActionsDoNotImplyRoleOrPermissionManagement`、`TestDelegatedUserActionsReachTransactionalStoreChecks`、`TestRolePermissionPreviewRequiresPermissionViewOverHTTP`、`TestBatchRoleAssignmentPreviewAndCommitOverHTTP`、`TestCopyAssignRoleOverHTTP`、`TestRoleMembersFilterBeforePagingAndBindCursor` 均覆盖门禁。 |
|
||||
| 成员目录最小信息 | PASS | 新端点 `GET /api/admin/roles/{roleId}/members` 仅返回 `RoleMember`（userId, owner, name, enabled, stateVersion, assignedAt, bindingVersion，`role_policy.go:1035-1045`），不含 profile.contact/isAdmin/凭据等。`TestRoleMembersFilterBeforePagingAndBindCursor` 末尾断言响应不包含 `profile` / `isAdmin`。光标绑定 role + filter + actor + directory revision，无法跨角色/参数复用（`account_search.go:296-307`）。 |
|
||||
| 预览只读无副作用 | PASS | `PreviewRolePermissions` 与 `PreviewUserRoleAssignments` 用 `tx.Begin()` + `defer tx.Rollback()`，无 `tx.Commit()`（`role_policy.go:665-686`、`1126-1159`）。`TestPreviewRolePermissionsIsReadOnly` 三组变更前后快照比对，断言 `roleVersion/epoch/receipts/permissions` 完全一致。`TestRolePermissionPreviewRequiresPermissionViewOverHTTP` 显式断言 viewer 调用 PUT 写端点被拒（`role_authorization_test.go:114-178`）。 |
|
||||
| 用户列表 search 端点最小信息 | 部分（详见非阻塞建议） | `GET /api/admin/users/search` 仍返回完整 `accountProfileJSON`（含 phone/email/staffNo/department/notes/isAdmin/initializationState），但 `searchAdminUsers` 在 actor 额外拥有 `system.roles.view` 时追加 `role` 投影（`account_search.go:194-237`）；本任务用此端点做批量分配 picker 时无可避免看到全 profile（仅用于选定人员），非新增行为，非本任务评审焦点。 |
|
||||
| 受保护动作不可降级到角色矩阵 | PASS | `normalizePermissionChanges` 在 `descriptor.Protected=true` 时拒绝写入（`role_policy.go:566-569`），`TestCatalogRejectsUnknownAndProtectsManagementActions` 验证所有 `system.*` 管理动作 `Protected=true`。前端 `catalog.filter(item => !item.protected)`（`RolePermissionsPanel.tsx:521`）从矩阵排除这些动作。 |
|
||||
|
||||
---
|
||||
|
||||
## 非阻塞建议（不阻塞 PR 合入；可作为后续增量）
|
||||
|
||||
1. **跨角色 row-lock 顺序与 deadlock**：`PatchRolePermissionsBatch` / `AssignUserRolesBatch` / `CreateRoleCopyAndAssign` 内对角色行 `FOR UPDATE` 的顺序由请求 `items` 切片决定，未按 roleID 排序。`policyWriteBatch` 仅对 actor + target users 按 owner 排序；跨 actor + 跨事务的不同 `items` 顺序理论上可能触发 PG 死锁检测（事务回滚，非数据损坏）。建议：批量入口按 roleID 升序排序 `items` 后再入 fn，或由 `policyWriteBatch` 在 fn 之前排序 items。非阻塞，仅在极高并发 + 不同顺序组合下产生瞬时回滚。
|
||||
|
||||
2. **`searchAdminUsers` 返回完整 profile**：批量分配 picker 在选择用户时不需要 `phone / email / staffNo / department / notes / isAdmin / passwordSet / initializationState`；可考虑按 view 端点（`system.users.view`）与 assign 端点（`system.roles.assign`）返回裁剪字段，或新增 `fields` 显式控制响应字段（现有 `fields` 仅控制过滤字段）。非阻塞，属既有端点行为。
|
||||
|
||||
3. **`roleDraftLeaveGuard.current = null` 在 unmount 时由 effect cleanup 复位**：`RolePermissionsPanel.tsx:431` 的 effect cleanup 会在依赖变化（`dirtyKey` 变化）时立即把 `current` 置 null；这与"新守卫被设置"的顺序是先 set 后清，存在极短的 `current === null` 间隙（毫秒级）。在 AdminZone 返回按钮的 click 期间几乎不会被命中；如需更稳，可改用 `useRef` 直接保存守卫函数 + `useCallback`，避免 effect 驱动的 reset。非阻塞。
|
||||
|
||||
4. **`canManagePermissions` 取 view 失败时不显示空态**：当 `permissionCatalog()` 拒绝时，`load` 会清空 `catalogFailed=true` 并在选中角色之后追加错误（`RolePermissionsPanel.tsx:501-507`）。与原 DR10 备注一致（保留部分失败可见性），实现正确；建议把 `editable` 同步置 `false` 并在 `focus()` 内显式提示当前矩阵不可编辑，以避免在慢网络下"已切换单角色视图 → 单元格短暂可编辑 → catalog 失败回填"造成闪烁。属 UX 微调，非阻塞。
|
||||
|
||||
5. **`PATCH /api/me/profile` 与权限 patch 两条路径的 `adoptRoleSnapshot` 语义**：当 `PATCH /admin/roles/{id}`（资料 / 启停）成功后 `setDrafts(prev => adoptRoleSnapshot(prev, selected.roleVersion, updated))`（`RolePermissionsPanel.tsx:488`）继承新 roleVersion；但权限草稿在资料/启停 patch 之后仍属同一角色 → 同一基线；当前实现对 `adoptRoleSnapshot` 的判定是"当前基线 roleVersion === 期望 roleVersion 时采纳新 row"，逻辑正确，仅在资料 patch 与权限 patch 并发时存在 `expectedVersion != 实际 version` 的窗口（被下一次 save 的 409 路径正确处理）。建议在 `adoptRoleSnapshot` 注释中明示"用于 PATCH 后的非权限写成功继承"。非阻塞。
|
||||
|
||||
---
|
||||
|
||||
## 不属于本任务范围（按任务卡 NOT_RUN 处置，未列入阻塞/建议）
|
||||
|
||||
- C13 成员共享读取（依赖 L1 U7）
|
||||
- C14 完整键盘 / 读屏人工走查
|
||||
- C16 日常实例采用（未授权部署）
|
||||
|
||||
---
|
||||
|
||||
## 引用文件位置索引
|
||||
|
||||
- Backend：`.task/feature-iam-role-permission-linked-capabilities-perm-ux.md` → 组件 commit `modules/backend @ 4130ad78`
|
||||
- 关键文件：`modules/backend/internal/store/role_policy.go`、`modules/backend/internal/server/roles.go`、`modules/backend/internal/server/account_search.go`、`modules/backend/internal/authz/catalog/catalog.go`、`modules/backend/internal/authz/service.go`、`modules/backend/pkg/extension/role_policy.go`
|
||||
- 单测：`modules/backend/internal/store/role_policy_test.go`、`modules/backend/internal/server/role_authorization_test.go`、`modules/backend/internal/authz/catalog/catalog_test.go`
|
||||
- Frontend：组件 commit `modules/frontend @ 46a63f02`
|
||||
- 关键文件：`modules/frontend/src/components/RolePermissionsPanel.tsx`、`modules/frontend/src/components/AccountUsersPanel.tsx`、`modules/frontend/src/components/adminRdmSections.tsx`、`modules/frontend/src/rolePermissions.ts`、`modules/frontend/src/roleMembers.ts`、`modules/frontend/src/permissionExplanations.ts`、`modules/frontend/src/api.ts`、`modules/frontend/src/styles.css`
|
||||
- 单测：`modules/frontend/test/design-guard.test.ts`、`modules/frontend/test/role-permissions.test.ts`、`modules/frontend/test/role-permissions-ui.test.ts`、`modules/frontend/test/role-members.test.ts`、`modules/frontend/test/permission-explanations.test.ts`、`modules/frontend/test/account-users-panel.test.ts`
|
||||
- 活体：`modules/frontend/e2e/iam-perm-ux-live.playwright.ts`
|
||||
- Dev 父仓：当前 `feature/iam-role-permission-linked-capabilities-perm-ux @ 234ce30`（基线 90317d02；组合 gitlink `modules/backend @ 4130ad7` + `modules/frontend @ 46a63f0`）
|
||||
+48
-34
@@ -7,19 +7,22 @@ parser accepts exactly one `agent-execution` fenced block.
|
||||
|
||||
U3's execution controller and U4's project wiring are integrated. This file is
|
||||
the execution-routing authority for implementation, repair, test, and review.
|
||||
Normal implementation, repair, and test routes stay Cursor, Antigravity
|
||||
(`agy`), and PI. Each of those profiles may be attempted up to
|
||||
`max_attempts_per_profile`, which is exactly 3 whenever `emergency_profile`
|
||||
is configured. Only after those candidates safely exhaust their attempts does
|
||||
the enabled emergency `codex` profile run once. Codex remains out of the three
|
||||
normal role lists and may also appear in review. `fallback_to_host` is
|
||||
`never`: the controller does not emit `host-fallback-authorized` and does not
|
||||
increment host fallback authorizations. Safe exhaustion without an emergency
|
||||
candidate ends `unavailable` or `blocked`, and that result does not authorize
|
||||
the host to write the unit. The legacy value `all-unavailable` remains
|
||||
parseable and likewise grants no host write authority. Cursor uses
|
||||
`cursor-agent-stable`. `model: auto` lets a CLI use its configured default
|
||||
model; any other value is passed to that CLI as its model selector. The
|
||||
Implementation, repair, test, and review all use the candidates Cursor,
|
||||
Antigravity (`agy`), PI with GLM (`pi-glm`), PI with MiniMax (`pi`), and
|
||||
Codex. Each candidate may be attempted up to `max_attempts_per_profile` (3)
|
||||
times on safe recoverable failures (`unavailable`, `failed-clean`); after that
|
||||
the controller moves to the next candidate automatically, and the host does
|
||||
not ask the user. The order of the non-Codex candidates may differ per role,
|
||||
but Codex must stay the last candidate in every role list. There is no
|
||||
`emergency_profile`. `fallback_to_host` is `never`: the controller does not
|
||||
emit `host-fallback-authorized` and does not increment host fallback
|
||||
authorizations. When every candidate is safely exhausted the run ends
|
||||
`unavailable` or `blocked`; the host pauses that unit and asks the user
|
||||
whether to retry, and does not write the unit. The legacy value
|
||||
`all-unavailable` remains parseable and likewise grants no host write
|
||||
authority. Cursor uses `cursor-agent-stable`. `model: auto` makes Cursor
|
||||
receive an explicit `--model auto`; the other CLIs omit the model flag and use
|
||||
their configured default. Any other value is passed to that CLI as its model selector. The
|
||||
`integration` block declares the host-exempt paths and the transport, admission,
|
||||
and cleanup entry points.
|
||||
|
||||
@@ -36,25 +39,34 @@ execution:
|
||||
summary_bytes: 16384
|
||||
raw_output_bytes: 10485760
|
||||
max_attempts_per_profile: 3
|
||||
emergency_profile: codex
|
||||
|
||||
roles:
|
||||
implementation: [cursor, antigravity, pi]
|
||||
repair: [cursor, antigravity, pi]
|
||||
test: [pi, antigravity, cursor]
|
||||
review: [pi, antigravity, cursor, codex]
|
||||
implementation: [cursor, antigravity, pi-glm, pi, codex]
|
||||
repair: [cursor, antigravity, pi-glm, pi, codex]
|
||||
test: [pi-glm, pi, antigravity, cursor, codex]
|
||||
review: [pi-glm, pi, antigravity, cursor, codex]
|
||||
|
||||
profiles:
|
||||
cursor:
|
||||
adapter: cursor
|
||||
executable: cursor-agent-stable
|
||||
model: auto
|
||||
# Re-enabled 2026-10-20: the earlier disable was based on a misreading
|
||||
# of ActionRequiredError — the real cause was the DM executor not
|
||||
# passing --model auto (cursor fell back to a quota-limited model).
|
||||
# Fixed by PR #644 (deps/development-manager pin); quota itself is fine.
|
||||
enabled: true
|
||||
|
||||
antigravity:
|
||||
adapter: antigravity
|
||||
executable: agy
|
||||
model: auto
|
||||
model: gemini-3.8-flash-high
|
||||
enabled: true
|
||||
|
||||
pi-glm:
|
||||
adapter: pi
|
||||
executable: pi
|
||||
model: zai-coding-cn/glm-5.3-flash
|
||||
enabled: true
|
||||
|
||||
pi:
|
||||
@@ -66,7 +78,7 @@ profiles:
|
||||
codex:
|
||||
adapter: codex
|
||||
executable: codex
|
||||
model: auto
|
||||
model: gpt-6.1-sol
|
||||
enabled: true
|
||||
|
||||
integration:
|
||||
@@ -91,23 +103,25 @@ section records only this project's choices.
|
||||
|
||||
- Planning, design and implementation plans: Codex or Claude when available,
|
||||
in the host or a fresh CLI session. This is a preference, not a routing role.
|
||||
- Bounded implementation, repair and test units: the existing normal
|
||||
candidates in the configured role order above. Requested models:
|
||||
- PI: `minimax-cn/MiniMax-M3`, passed as `--model provider/id`. PI
|
||||
actual events have reported `minimax-cn` / `MiniMax-M3` and the local
|
||||
offline catalog lists that profile; each run still records the effective
|
||||
model from that run's events.
|
||||
- Cursor: `auto` (Cursor Auto).
|
||||
- agy: Gemini 3.8 Flash is requested, but its exact selectable model ID and
|
||||
effective identity are `NOT_VERIFIED` (the `agy` models query needs a
|
||||
login that was not available). The profile therefore stays `model: auto`
|
||||
until an observed model ID exists; do not claim Gemini 3.8 Flash is active.
|
||||
- Bounded implementation, repair, test and review units: the candidates in
|
||||
the configured role order above, with Codex last. Requested models:
|
||||
- Cursor: `auto`, passed explicitly as `--model auto` (Cursor Auto).
|
||||
- agy: `gemini-3.8-flash-high`. `agy models` listed it on 2026-10-20 and a
|
||||
one-line smoke run answered; the effective identity is still taken from
|
||||
each run's events.
|
||||
- PI GLM profile (`pi-glm`): `zai-coding-cn/glm-5.3-flash`, passed as
|
||||
`--model provider/id`.
|
||||
- PI MiniMax profile (`pi`): `minimax-cn/MiniMax-M3`, passed as
|
||||
`--model provider/id`. PI actual events have reported `minimax-cn` /
|
||||
`MiniMax-M3` and the local offline catalog lists that profile; each run
|
||||
still records the effective model from that run's events.
|
||||
- Codex: `gpt-6.1-sol`, always the last candidate.
|
||||
- Assigning a different candidate or model to a unit needs a concrete,
|
||||
task-specific reason recorded in the task record, and stays within the
|
||||
existing roles and candidate lists. It is not a silent permission or routing
|
||||
change. Role lists, attempt limits, timeouts, output limits, the single
|
||||
Codex emergency attempt, stage isolation and `fallback_to_host: never` are
|
||||
unchanged by these preferences.
|
||||
change. Role lists, attempt limits, timeouts, output limits, Codex as the
|
||||
last candidate, stage isolation and `fallback_to_host: never` are unchanged
|
||||
by these preferences.
|
||||
- A requested model is prompt/config intent. Only the model reported in a
|
||||
run's actual event envelope counts as effective; when the CLI does not report
|
||||
it, record `not-observable`. Unknown context capacity, a missing agy login
|
||||
|
||||
@@ -44,6 +44,7 @@
|
||||
- 智能体完成 Review、解决冲突并确认当前 HEAD 必需 CI 通过后执行合入，无需另请人工操作。
|
||||
- 合入后仅在已登记任务 worktree 根目录、确认所有写者退出后回收；父子仓改动与未跟踪/ignored 唯一文件先保存或处置，删除被拒时保留现场，禁止强删兜底。
|
||||
- 放弃未合入工作用 `make task-finish ABANDON="--abandon <原因>"` 并记录原因，不豁免现场保护。
|
||||
- 每次结束用户任务，最终回复末尾附简短自包含的交接块，供清空上下文后续办；它只是摘要，不替代任务卡、持久交接或证据。无仓库变更也无续办状态时，写一行明确的“不适用”。字段与细则见 [对话收尾交接块](policy/delivery.md#对话收尾交接块)。
|
||||
- 首次克隆后运行 `make setup` 启用本地钩子；治理脚本改动须运行 `make test-governance`（见 [持续回归](policy/governance.md#持续回归)）。
|
||||
- 命令与细则：[启动与恢复](policy/governance.md#启动与恢复)、[回收](policy/governance.md#回收)、[两级分支与分流](policy/delivery.md#两级分支交付模型与分流检查)、[分级门禁](policy/delivery.md#层级任务通道与分级门禁)、[合入调度](policy/delivery.md#合入调度)、[Review 与合入](policy/delivery.md#智能体-review-与-pr-合入)。
|
||||
|
||||
|
||||
@@ -13,7 +13,7 @@ PLUGINS := plugins
|
||||
COMBO := core=$(shell git -C $(CORE) rev-parse --short HEAD 2>/dev/null)+backend=$(shell git -C $(BACKEND) rev-parse --short HEAD 2>/dev/null)+frontend=$(shell git -C $(FRONTEND) rev-parse --short HEAD 2>/dev/null)+ui=$(shell git -C $(UI) rev-parse --short HEAD 2>/dev/null)+agentcmd=$(shell git -C deps/agent-command rev-parse --short HEAD 2>/dev/null)+documents=$(shell git -C modules/documents rev-parse --short HEAD 2>/dev/null)+native=$(shell git -C deps/agent-native rev-parse --short HEAD 2>/dev/null)+squad=$(shell git -C deps/agent-squad rev-parse --short HEAD 2>/dev/null)+intent=$(shell git -C deps/agent-intent rev-parse --short HEAD 2>/dev/null)
|
||||
VERSION := $(shell git describe --tags --always --dirty 2>/dev/null)+$(COMBO)
|
||||
|
||||
.PHONY: help sync status build frontend svc svc-list svc-info svc-commits svc-history svc-update svc-recover svc-watchdog test-backend test-backend-pg test-multi-instance test-lifecycle test-regulations-kb test-frontend test-ui test-core test-agentcmd test-pins test-libs dev pin clean setup precheck task-triage task-triage-decide task-start task-resume task-sync task-close task-finish task-pr-check ci-wait facts-verify evidence version agent-exec-validate agent-exec-apply agent-exec-admit
|
||||
.PHONY: help sync status build frontend svc svc-list svc-info svc-commits svc-history svc-update svc-recover svc-watchdog test-backend test-backend-pg test-multi-instance test-lifecycle test-regulations-kb test-frontend test-ui test-core test-agentcmd test-pins test-libs dev pin clean setup precheck task-triage task-triage-decide task-start task-resume task-sync task-close task-finish task-pr-check ci-wait facts-verify evidence version agent-exec-validate agent-exec-apply agent-exec-admit image-build image-verify
|
||||
|
||||
version:
|
||||
@echo "agent-system $(VERSION)"
|
||||
@@ -99,6 +99,8 @@ help:
|
||||
@echo "make dev 开发模式说明（前后端分离热更新）"
|
||||
@echo "make pin 推进 submodule 指针到各仓远端 main（提交前须 make test 通过）"
|
||||
@echo "make status submodule 状态"
|
||||
@echo "make image-build 构建 Docker 测试环境镜像 agent-system-test-env:dev"
|
||||
@echo "make image-verify 运行镜像内环境自检 verify-env.sh"
|
||||
@echo "make agent-exec-validate 校验 AGENT-EXECUTION.md（scripts/agent-exec validate，经 dm-server agent-exec）"
|
||||
@echo "make agent-exec-apply RECEIPT=<path> 快进当前分支到成功收据的 transport"
|
||||
@echo "make agent-exec-admit 校验暂存路径具备 transport 来源或属于 host 豁免"
|
||||
@@ -118,6 +120,12 @@ agent-exec-apply:
|
||||
agent-exec-admit:
|
||||
scripts/agent-exec admit --repo .
|
||||
|
||||
image-build:
|
||||
docker build -t agent-system-test-env:dev docker/
|
||||
|
||||
image-verify:
|
||||
docker run --rm --shm-size=1g agent-system-test-env:dev /usr/local/bin/verify-env.sh
|
||||
|
||||
sync:
|
||||
git submodule update --init --recursive --jobs 8
|
||||
|
||||
|
||||
Vendored
+1
-1
Submodule deps/agent-native updated: 28f3ea7674...2fc66be652
Vendored
+1
-1
Submodule deps/agent-squad updated: 11ff3a0a9c...c7121bda2a
Vendored
+1
-1
Submodule deps/development-manager updated: 6c019595fa...1e5ee55a28
@@ -0,0 +1,50 @@
|
||||
FROM --platform=linux/amd64 ubuntu:24.04
|
||||
|
||||
ENV DEBIAN_FRONTEND=noninteractive
|
||||
ENV PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright
|
||||
ENV PATH=/usr/local/go/bin:/usr/local/lib/nodejs/node-v26.10.0-linux-x64/bin:${PATH}
|
||||
|
||||
RUN apt-get update \
|
||||
&& apt-get install -y --no-install-recommends \
|
||||
ca-certificates \
|
||||
curl \
|
||||
git \
|
||||
libatomic1 \
|
||||
make \
|
||||
openssh-server \
|
||||
sudo \
|
||||
xz-utils \
|
||||
software-properties-common \
|
||||
&& add-apt-repository -y ppa:deadsnakes/ppa \
|
||||
&& apt-get update \
|
||||
&& apt-get install -y --no-install-recommends \
|
||||
python3.14 \
|
||||
python3.14-venv \
|
||||
&& python3.14 -m ensurepip --upgrade \
|
||||
&& ln -sf /usr/bin/python3.14 /usr/local/bin/python3 \
|
||||
&& ln -sf /usr/bin/python3.14 /usr/local/bin/python \
|
||||
&& rm -rf /var/lib/apt/lists/*
|
||||
|
||||
RUN curl -fsSL https://go.dev/dl/go1.27.1.linux-amd64.tar.gz -o /tmp/go1.27.1.linux-amd64.tar.gz \
|
||||
&& rm -rf /usr/local/go \
|
||||
&& tar -C /usr/local -xzf /tmp/go1.27.1.linux-amd64.tar.gz \
|
||||
&& curl -fsSL https://nodejs.org/dist/v26.10.0/node-v26.10.0-linux-x64.tar.xz -o /tmp/node-v26.10.0-linux-x64.tar.xz \
|
||||
&& mkdir -p /usr/local/lib/nodejs \
|
||||
&& tar -C /usr/local/lib/nodejs -xJf /tmp/node-v26.10.0-linux-x64.tar.xz \
|
||||
&& npx -y playwright@1.64.0 install --with-deps chromium \
|
||||
&& rm -f /tmp/go1.27.1.linux-amd64.tar.gz /tmp/node-v26.10.0-linux-x64.tar.xz \
|
||||
&& rm -rf /var/lib/apt/lists/*
|
||||
|
||||
RUN userdel -r ubuntu 2>/dev/null || true \
|
||||
&& groupdel ubuntu 2>/dev/null || true \
|
||||
&& groupadd --gid 1000 dev \
|
||||
&& useradd --uid 1000 --gid 1000 --create-home --shell /bin/bash dev \
|
||||
&& echo "dev ALL=(ALL) NOPASSWD:ALL" > /etc/sudoers.d/dev \
|
||||
&& chmod 0440 /etc/sudoers.d/dev \
|
||||
&& printf '\nPermitRootLogin no\nPasswordAuthentication no\nPubkeyAuthentication yes\n' >> /etc/ssh/sshd_config
|
||||
|
||||
COPY --chmod=755 entrypoint.sh /usr/local/bin/entrypoint.sh
|
||||
COPY --chmod=755 verify-env.sh /usr/local/bin/verify-env.sh
|
||||
|
||||
EXPOSE 22
|
||||
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
|
||||
@@ -0,0 +1,57 @@
|
||||
# Docker 测试环境镜像说明
|
||||
|
||||
## 用途与边界
|
||||
|
||||
本目录用于定义一个可重复构建的隔离测试环境镜像，供后续用该镜像启动一次性容器、挂载当前仓库做隔离测试。
|
||||
|
||||
- 该镜像只提供测试运行环境，不包含仓库代码。
|
||||
- 该镜像不包含任何密钥、私钥或凭据。
|
||||
- 本仓正式交付流程仍以非容器化路径为准，此镜像仅用于辅助隔离测试。
|
||||
|
||||
## 构建与自检
|
||||
|
||||
在仓库根目录执行：
|
||||
|
||||
```bash
|
||||
make image-build
|
||||
make image-verify
|
||||
```
|
||||
|
||||
- `make image-build`：构建镜像 `agent-system-test-env:dev`。
|
||||
- `make image-verify`：运行镜像内环境自检脚本 `/usr/local/bin/verify-env.sh`。
|
||||
|
||||
## 启动测试容器示例
|
||||
|
||||
```bash
|
||||
docker run -d --name asdev-test --shm-size=1g -p 127.0.0.1:2222:22 -v ~/.ssh/id_ed25519.pub:/home/dev/.ssh/authorized_keys:ro -v $PWD:/workspace agent-system-test-env:dev
|
||||
```
|
||||
|
||||
说明：
|
||||
|
||||
- `authorized_keys` 挂载源可以替换为任意可用的 `.pub` 公钥文件。
|
||||
- 容器内 SSH 登录用户为 `dev`。
|
||||
- `dev` 用户已配置 sudo 免密。
|
||||
|
||||
进入容器：
|
||||
|
||||
```bash
|
||||
ssh -p 2222 dev@127.0.0.1
|
||||
```
|
||||
|
||||
## 容器内最小测试流程
|
||||
|
||||
```bash
|
||||
cd /workspace
|
||||
make sync
|
||||
cd modules/frontend
|
||||
npm ci
|
||||
npx playwright test
|
||||
```
|
||||
|
||||
说明：镜像已内置 `PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright` 下的 Chromium，通常无需在容器内再次执行 `playwright install`。
|
||||
|
||||
## 安全说明
|
||||
|
||||
- 容器内无密码登录，仅允许公钥认证。
|
||||
- 每个容器实例在启动时独立生成 SSH host key。
|
||||
- 不要将生产凭据、私钥或其他敏感文件带进容器。
|
||||
@@ -0,0 +1,23 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
|
||||
mkdir -p /run/sshd
|
||||
ssh-keygen -A
|
||||
|
||||
install -d -m 0700 -o dev -g dev /home/dev/.ssh
|
||||
|
||||
if [ -f /home/dev/.ssh/authorized_keys ]; then
|
||||
tmp_authorized_keys="$(mktemp)"
|
||||
cp /home/dev/.ssh/authorized_keys "${tmp_authorized_keys}"
|
||||
install -m 0600 -o dev -g dev "${tmp_authorized_keys}" /home/dev/.ssh/authorized_keys 2>/dev/null || {
|
||||
chown dev:dev /home/dev/.ssh/authorized_keys 2>/dev/null || true
|
||||
chmod 0600 /home/dev/.ssh/authorized_keys 2>/dev/null || true
|
||||
}
|
||||
rm -f "${tmp_authorized_keys}"
|
||||
fi
|
||||
|
||||
if [ "$#" -gt 0 ]; then
|
||||
exec "$@"
|
||||
fi
|
||||
|
||||
exec /usr/sbin/sshd -D -e
|
||||
@@ -0,0 +1,50 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
|
||||
fail_expect() {
|
||||
local expected="$1"
|
||||
local actual="$2"
|
||||
echo "校验失败: 期望: ${expected}"
|
||||
echo "校验失败: 实际: ${actual}"
|
||||
exit 1
|
||||
}
|
||||
|
||||
command -v git >/dev/null 2>&1 || fail_expect "git 可执行文件存在" "git 不存在"
|
||||
command -v make >/dev/null 2>&1 || fail_expect "make 可执行文件存在" "make 不存在"
|
||||
|
||||
go_version="$(go version 2>&1 || true)"
|
||||
[[ "${go_version}" == *"go1.27.1"* ]] || fail_expect "go version 输出包含 go1.27.1" "${go_version}"
|
||||
|
||||
node_version="$(node --version 2>&1 || true)"
|
||||
[[ "${node_version}" == "v26.10.0" ]] || fail_expect "v26.10.0" "${node_version}"
|
||||
|
||||
npm_version="$(npm --version 2>&1 || true)"
|
||||
[[ -n "${npm_version}" ]] || fail_expect "npm --version 有输出" "空输出"
|
||||
|
||||
python_version="$(python3 --version 2>&1 || true)"
|
||||
[[ "${python_version}" =~ ^Python\ 3\.14\.[0-9]+$ ]] || fail_expect "Python 3.14.x" "${python_version}"
|
||||
|
||||
if ! sshd_output="$(sshd -t 2>&1)"; then
|
||||
fail_expect "sshd -t 检查通过" "${sshd_output}"
|
||||
fi
|
||||
|
||||
id dev >/dev/null 2>&1 || fail_expect "用户 dev 存在" "用户 dev 不存在"
|
||||
|
||||
sudo_list="$(sudo -l -U dev 2>&1 || true)"
|
||||
echo "${sudo_list}" | grep -q "NOPASSWD" || fail_expect "sudo -l -U dev 含 NOPASSWD" "${sudo_list}"
|
||||
|
||||
if [ "${PLAYWRIGHT_BROWSERS_PATH:-}" != "/opt/ms-playwright" ]; then
|
||||
fail_expect "PLAYWRIGHT_BROWSERS_PATH=/opt/ms-playwright" "${PLAYWRIGHT_BROWSERS_PATH:-<未设置>}"
|
||||
fi
|
||||
|
||||
chromium_path="$(
|
||||
find /opt/ms-playwright -type f \( -name headless_shell -o -name chrome \) 2>/dev/null | head -n 1
|
||||
)"
|
||||
|
||||
[ -n "${chromium_path}" ] || fail_expect "在 /opt/ms-playwright 下存在 headless_shell 或 chrome" "未找到可执行文件"
|
||||
[ -x "${chromium_path}" ] || fail_expect "chromium 可执行文件具有执行权限" "${chromium_path} 不可执行"
|
||||
|
||||
chromium_dom="$("${chromium_path}" --headless --no-sandbox --disable-gpu --dump-dom about:blank 2>&1 || true)"
|
||||
echo "${chromium_dom}" | grep -q "<html" || fail_expect "chromium --dump-dom 输出包含 <html" "${chromium_dom}"
|
||||
|
||||
echo "verify-env: PASS"
|
||||
@@ -0,0 +1,75 @@
|
||||
# 快慢通道 O2：限路由等价终态 阶段 5 实施与测试计划
|
||||
|
||||
- 状态：**阶段 5 计划稿，待人审**（与[阶段 4 方案](../specs/2026-10-19-fast-slow-o2-route-contract-eof-design.md)同批评审）。人审通过前不派 worker、不改产品代码。
|
||||
- 日期：2026-10-19；作者：host；来源等级：SELF。
|
||||
- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）；worker 不提交、不推送、不开 PR；host 负责范围审阅、权威验证、PR/CI/合入。
|
||||
- 付费与真实模型：**本计划零付费部分不需要任何付费请求**；P1 付费验证另提资源方案并单独批准。
|
||||
|
||||
## 1. 交付切分与顺序
|
||||
|
||||
| 增量 | 仓 | 内容 | 依赖 | 合入方式 |
|
||||
|---|---|---|---|---|
|
||||
| I1 | Agent-Native | `runtime/argschema` 提炼 + 解析器延后判定 + `RouteContractEOF` 传输层判定 + 夹具 | 无 | 组件仓 PR，CI 通过后合入（组件仓无需 #518 窗口） |
|
||||
| I2 | Backend | 系统层设置键、`openLLMClient` 按身份挂合同、运行记录透传 `CompletionBasis` | I1 合入且 Backend `deps/agent-native` 改钉 | 组件仓 PR |
|
||||
| I3 | Dev | 改钉 Agent-Native 与 Backend，组合验证 `make test` | I1、I2 | #518 窗口合入 |
|
||||
| P1 | — | 1 次短工具探针 + 1 次 A01（付费） | I3 合入、资源方案获批、系统层配置写入 | 另行授权 |
|
||||
|
||||
各增量阶段 6 评审包写入 `docs/superpowers/specs/`；I1–I3 每个增量完成后先交用户阶段 6 再合入（与快慢通道既往 manual 口径一致）。
|
||||
|
||||
## 2. I1 Agent-Native（单元 `o2-i1-agent-native-route-contract`）
|
||||
|
||||
- **允许路径**：`runtime/llm/**`、`runtime/argschema/**`（新）、`runtime/tools/registry.go`、`runtime/tools/registry_test.go`。
|
||||
- **动作**：
|
||||
1. 新包 `runtime/argschema`：`Validate(schema, args json.RawMessage) error`，整体迁移现 `validateArgs` 与 `matchesType`，语义逐项相同；`registry.validateArgs` 改为委托，现有 registry 测试不改断言。
|
||||
2. 解析器：内部选项 `deferMissingDone`；新增计数 `finishChunks`、标志 `toolAfterFinish`。只有在“除缺 `[DONE]` 外全部现有检查通过”时才返回候选终态，否则行为同今。公开 `ParseSSE` 签名与零值行为不变。
|
||||
3. 传输层：`Client.RouteContract`；在 `bodyObserver` 快照后按方案 §4.2 的 C1–C9 判定；放行发 `message_end`（`CompletionBasis=route_contract_eof`，`StreamComplete=false`），拒绝发与今天相同文案的终态失败并附 `ContractCheck`。
|
||||
4. `Event`/`TerminalObservation` 新增 `CompletionBasis`、`ContractCheck`（JSON 字段名 `completionBasis`、`contractCheck`）。
|
||||
- **测试**（`httptest`；HTTP/2 用 `httptest.NewUnstartedServer` + `EnableHTTP2` + TLS）：
|
||||
|
||||
| 用例 | 期望 |
|
||||
|---|---|
|
||||
| 有 `[DONE]`（合同开/关） | 放行，`CompletionBasis=done_marker`，与现状一致 |
|
||||
| 无 `[DONE]`、合同关 | 拒绝，文案不变 |
|
||||
| 无 `[DONE]`、合同开、HTTP/2 正常结束、全部条件成立 | **放行**，`route_contract_eof`，工具调用逐字节等于输入 |
|
||||
| 同上但 `known_length`+`match` / `mismatch` | 依人审 §6.1 结论放行 / 拒绝（C2） |
|
||||
| `close_delimited`、`chunked`、`unknown` | 拒绝（C2） |
|
||||
| 缺 Usage | 拒绝（C5） |
|
||||
| Usage 在 `finish_reason` 块之前 / 之后 | 均放行（顺序不作要求，评估稿 §3） |
|
||||
| 两个非空 `finish_reason` 块；`finish_reason=stop` 或 `length` 却有工具；一块含多个 choice | 拒绝（C4） |
|
||||
| 在帧边界截断、无 `finish_reason`，但 HTTP/2 正常结束 | 拒绝（C4） |
|
||||
| HTTP/2 `RST_STREAM` 或连接中途断开导致读错 | 拒绝（C3） |
|
||||
| 与 `finish_reason` 同一块内的工具片段 / 后续块再出现工具片段 | 放行 / 拒绝（C6） |
|
||||
| 合同开但任一条件不满足 vs 合同关 | 两个终态事件除 `contractCheck` 外 deep-equal |
|
||||
| 哨兵扫描 | `contractCheck`、`completionBasis` 不含正文、工具名、参数或错误原文 |
|
||||
| 半帧 / 无效帧 / 供应商错误帧 | 拒绝（C3/C9） |
|
||||
| ID 或名称缺失、参数非 JSON 对象 | 拒绝（C7） |
|
||||
| 工具名不在请求 `tools`；缺 required；属性类型不符 | 拒绝（C8） |
|
||||
| 模型名不符、基址不符（含 http、userinfo、query）、摘要不符、`APIBase` 覆盖到他址、重定向（他主机、同主机改路径、降级） | 拒绝（C1） |
|
||||
| 读取中取消 | 中止事件，无放行 |
|
||||
|
||||
每个用例同时断言 Usage 保留与“放行次数/工具调用数”。
|
||||
- **验证**：`gofmt -l runtime`；`go vet ./runtime/...`；`go test ./runtime/llm/... ./runtime/argschema/... ./runtime/tools/... -count=1`；`git diff --check`。
|
||||
- **停止条件**：若延后判定需要改变公开 `ParseSSE` 的零值行为或既有测试断言，停止并回到方案评审。
|
||||
|
||||
## 3. I2 Backend（单元 `o2-i2-backend-route-contract-config`）
|
||||
|
||||
- **允许路径**：`internal/runtime/**`、`internal/settings/**`、`internal/runmgr/**`（仅透传字段）、Backend `deps/agent-native` gitlink（host 改钉，不由 worker 改）。
|
||||
- **动作**：`settings.Schema()` 以 `SettingScopeSystem` 声明三个扁平键 `models.routeContractEOF.model/.baseUrl/.identitySha256`（任一为空即关闭；用户/项目层由 `ManagedPaths` 剥除）；`openLLMClient` 增参 `ResolvedModel` 与配置，三元组与摘要全部精确一致才挂合同（按三元组、不看 `Kind`），5 个调用点 `llm.go`、`sub_loop.go`、`squad_runner.go`、`verify.go`、`workflow_compiled.go` 全部覆盖；轻量档、视觉改模、子代理独立判断；运行记录与快慢通道收据透传 `completionBasis`。
|
||||
- **测试**：缺省关闭；用户层写入被忽略；模型/基址/摘要任一不符不挂合同；视觉改模后不继承；挂合同后假流放行一次工具并记录 `route_contract_eof`；删除配置后恢复拒绝。
|
||||
- **验证**：`gofmt`；`go vet ./internal/runtime ./internal/settings ./internal/runmgr`；`go test ./internal/runtime ./internal/settings ./internal/runmgr -count=1`。
|
||||
|
||||
## 4. I3 Dev 组合
|
||||
|
||||
- host 改钉 `deps/agent-native`（I1 合入 SHA）与 `modules/backend`（I2 合入 SHA）；`make test` + `make build` 由 PR CI（GATE）确认；无产品代码改动。
|
||||
- 注意与同期 IAM 链路 initiative（Dev #628）对 Backend gitlink 的合入顺序：以合入时最新 main 为准重新组合验证，冲突由 host 选择包含双方的 Backend SHA，不回退对方提交。
|
||||
|
||||
## 5. P1 付费验证（不在本计划授权内）
|
||||
|
||||
- 前提：I3 合入；系统层配置写入目标路由三元组；核对 r0.6 证据身份（受保护路由文件 SHA-256 `2a92569d…`）与生产三元组指向同一模型/基址。
|
||||
- 内容：1 次短工具探针（预期约 500 tokens，参考 r0.5/r0.6），期望 `route_contract_eof` 放行且工具执行恰好一次；通过后 1 次 A01，规模参考 r0.4。
|
||||
- 另提资源方案（预算上限、停止条件、收据路径），用户批准后执行；失败即停、不补跑。
|
||||
|
||||
## 6. 完成与停止
|
||||
|
||||
- 零付费完成：I1–I3 合入，夹具全绿，配置缺省关闭时线上行为不变（以既有 `[DONE]` 与拒绝用例为回归证据）。
|
||||
- 停止并回到方案评审：需要改变 `StreamComplete` 语义、泛化到其他路由、或任何条件无法在本地确定性观察。
|
||||
@@ -0,0 +1,123 @@
|
||||
# 快慢通道 O2：限路由等价终态（`route_contract_eof`）方案
|
||||
|
||||
- 状态：**阶段 4 方案稿，待人审。** 本文不授权产品代码改动、付费请求、A01 复验或部署；阶段 4/5 人审通过后才按配套计划派 worker 实施零付费部分，付费探针另行提资源方案。
|
||||
- 日期：2026-10-19；作者：host（只读调查与文档撰写）；来源等级：SELF。
|
||||
- 决策来源：用户 2026-10-19 在[完成信号口径评估](2026-10-19-fast-slow-completion-signal-evaluation.md)中选定 **O2**（另起任务）。
|
||||
- 配套计划：[阶段 5 实施与测试计划](../plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md)。
|
||||
- 上游约束：[r0.6 传输完整性设计](../../../modules/documents/docs/proposals/2026-10-14-fast-slow-u3-r06-transport-completeness-design.md)的四个前提（评估稿第 4 节逐项对照）；本方案是该设计要求的“另一轮方案评审”，不改变 r0.6 已批准的观察字段。
|
||||
|
||||
## 1. 目标与非目标
|
||||
|
||||
**目标**：对**一条经核验的 MiniMax 路由**，在流缺少字面 `[DONE]`、但能证明“按协议结束且工具调用完整”时，放行该轮工具调用；其余一切情形保持现行拒绝。
|
||||
|
||||
**非目标**：
|
||||
|
||||
- 不改变有 `[DONE]` 的现有放行路径与 `StreamComplete` 语义。
|
||||
- 不对其他 OpenAI 兼容服务、其他 MiniMax 模型或其他主机泛化；不提供“全局放宽”开关。
|
||||
- 不在本轮跑真实 A01 或任何付费请求；不改 Anthropic 协议路径。
|
||||
- 不引入完整 JSON Schema 引擎（见 §4.3 的子集约定）。
|
||||
|
||||
## 2. 现状（代码定位，Agent-Native `origin/main` 9c24e22 / Dev 钉 28f3ea7 同文件）
|
||||
|
||||
| 位置 | 现行行为 |
|
||||
|---|---|
|
||||
| `runtime/llm/sse.go` `emitParsed` 第 260 行起 | 有工具调用且 `!sawDone` → `sendTerminalFailure("tool call stream ended before [DONE]")`，工具全部丢弃，Usage 保留 |
|
||||
| `runtime/llm/sse.go` 第 300 行 | 正常结束发 `message_end`，`StreamComplete = sawDone` |
|
||||
| `runtime/llm/client.go` `run` 第 129–139 行 | 用 `bodyObserver` 包住响应体；`ParseSSE` 的终态事件发出后才补 `TerminalObservation.BodyBoundary` |
|
||||
| `runtime/llm/body_observation.go` | 只按 `net/http` 可见信息分类：`http2_stream` / `known_length` / `chunked` / `close_delimited` / `unknown`；`LengthRelation` 仅在已知长度、未解压、未饱和且见 EOF 时为 `match`/`mismatch` |
|
||||
| `runtime/tools/registry.go` `validateArgs` | 工具**执行前**按 schema 子集（`type`、`required`、属性类型）校验参数；失败返回错误结果、不执行 |
|
||||
| Backend `internal/runtime/model.go` `ResolvedModel` | 路由身份 = `Kind` + `Model` + `Base`（设置层 → 画像覆盖）；生产无独立“路由文件” |
|
||||
| Backend `internal/runtime/llm.go` `openLLMClient` | 构造 `agentllm.Client`；`MiniMax-M*` 置 `ReasoningSplit` |
|
||||
|
||||
关键约束：**判定所需的传输边界只在 `client.go` 可见**，`ParseSSE` 看不到；因此终态判定不能只放在解析器里。
|
||||
|
||||
## 3. 方案总览
|
||||
|
||||
```
|
||||
ParseSSE（解析器） Client.run（传输层）
|
||||
────────────────── ────────────────────
|
||||
既有检查全部照旧 bodyObserver 快照
|
||||
仅当“唯一缺陷 = 缺 [DONE]”且 ↓
|
||||
调用方声明了路由合同时 → RouteContractEOF.Evaluate(candidate, boundary, tools)
|
||||
返回 候选终态（不外发） ────────────▶ 全部条件成立 → message_end（CompletionBasis=route_contract_eof）
|
||||
任一不成立 → 与今天相同的终态失败（Usage 保留）
|
||||
```
|
||||
|
||||
- 合同未配置（零值）时，解析器与客户端的行为**逐字节等同现状**。
|
||||
- 解析器只做“延后判定”，不做放行；放行只在传输层、且只对绑定身份。
|
||||
|
||||
## 4. 设计细节
|
||||
|
||||
### 4.1 路由合同与身份绑定（Agent-Native `runtime/llm`）
|
||||
|
||||
新增导出类型（命名可在计划阶段微调，语义固定）：
|
||||
|
||||
```go
|
||||
// RouteContractEOF 只对一条经核验路由生效；零值/nil 表示关闭。
|
||||
type RouteContractEOF struct {
|
||||
Model string // 精确模型名，例如 MiniMax-M3
|
||||
BaseURL string // 规范化后的精确基址，例如 https://api.minimaxi.com/v1
|
||||
IdentitySHA256 string // sha256("openai-chat\n" + Model + "\n" + BaseURL)
|
||||
}
|
||||
```
|
||||
|
||||
`Client` 增加可选字段 `RouteContract *RouteContractEOF`。生效前提（任一不满足即视为关闭，回到现行拒绝）：
|
||||
|
||||
1. `Protocol` 为 openai-chat；
|
||||
2. 本次请求实际使用的 `model` 与 `Model` 精确相等；
|
||||
3. 本次请求实际使用的基址（含 `StreamOptions.APIBase` 覆盖）规范化后与 `BaseURL` 精确相等。规范化规则：只允许 `https`；scheme 与 host 转小写；去掉末尾 `/`；含 userinfo、query 或 fragment 一律视为不匹配（规则只会失败关闭，不放宽）；
|
||||
4. 由 1–3 重算的摘要等于 `IdentitySHA256`（防止宿主误配一半字段）；
|
||||
5. 请求没有被重定向：`resp.Request.URL`（net/http 的最终请求）的 scheme、host、port、path 与原始请求逐项相等；同主机改路径或 https 降级都视为不匹配。
|
||||
|
||||
r0.6 探针所记的受保护路由文件 SHA-256（`2a92569d…`）是**证据身份**，用于核对“被观察的就是这条路由”；生产绑定用上面的三元组摘要，二者在计划的付费探针前做一次映射核对。
|
||||
|
||||
### 4.2 放行条件（全部成立才放行）
|
||||
|
||||
| # | 条件 | 数据来源 |
|
||||
|---|---|---|
|
||||
| C1 | 路由合同生效（§4.1 的 1–5） | `Client` + 请求 + 响应 |
|
||||
| C2 | 传输按协议结束：`FramingClass=http2_stream` 且 `EOFSeen`，或 `known_length` 且 `LengthRelation=match` | `BodyBoundaryObservation` |
|
||||
| C3 | `ReadOutcome=clean_eof`；无取消、读错、无效帧、供应商错误 | `TerminalObservation` |
|
||||
| C4 | 恰好一个带非空 `finish_reason` 的块，且其值为 `tool_calls`；合同生效时每块 `len(choices) <= 1`（解析器只读 `choices[0]`，多 choice 不得被静默丢弃） | 解析器新增计数 |
|
||||
| C5 | 请求开启 `include_usage`（客户端恒开）且收到 Usage | `UsagePresent` |
|
||||
| C6 | `finish_reason` 块之后的**后续块**中没有任何工具片段（与 `finish_reason` 同一块内的片段允许） | 解析器新增标志 |
|
||||
| C7 | 每个工具调用 ID、名称齐全，参数为 JSON 对象 | 现有检查 |
|
||||
| C8 | 每个调用的名称在本次请求声明的 `tools` 中，参数通过该工具 schema 子集校验（§4.3） | 请求 `tools` |
|
||||
| C9 | 最后一帧 JSON 完整，`TailEventKind=json_frame` | `TerminalObservation` |
|
||||
|
||||
`chunked`、`close_delimited`、`unknown`、`known_length` 但 `mismatch`/`unknown` 一律不满足 C2。
|
||||
|
||||
### 4.3 参数 schema 子集
|
||||
|
||||
C8 采用与 `tools.registry.validateArgs` **相同**的语义：整体迁移 `validateArgs` 与 `matchesType`，语义不变——顶层 `type: object`、`required` 必填项（空白字符串视为缺失）、已声明属性的基本类型、声明了 `properties` 时拒绝未知参数。实现上把该校验提炼到新的无依赖小包 `runtime/argschema` 中的单一函数，`runtime/llm` 与 `runtime/tools` 都调用它（两包当前互不导入，放进任一方都会引入新的包依赖方向），避免两套语义漂移。超出子集的约束（枚举、格式、嵌套）不在本轮，registry 执行前校验仍保留作为第二道门。
|
||||
|
||||
### 4.4 输出与可观测性
|
||||
|
||||
- 放行时：`message_end` 正常携带工具调用；`StreamComplete` **保持 false**（字面含义仍是“未见 `[DONE]`”）；新增 `Event.CompletionBasis`：`done_marker`（现有路径）或 `route_contract_eof`。
|
||||
- `TerminalObservation` 新增 `CompletionBasis` 与 `ContractCheck`（失败时记录第一个不满足的条件编号，例如 `C2`），不保存正文、参数或密钥。
|
||||
- 拒绝时：除 `TerminalObservation.ContractCheck` 外，终态事件与“合同关闭”时**逐字段一致**（Content、Thinking、`StopError`、Usage、FinishReason、错误文案 `tool call stream ended before [DONE]`）。实现上解析器的候选终态同时携带预先构造的失败事件，`Client.run` 判定失败即原样发出。
|
||||
- `CompletionBasis`、`ContractCheck` 只取枚举值，不含正文、工具名、参数或供应商错误原文。
|
||||
- 下游（Backend 运行记录、快慢通道收据）只把 `CompletionBasis` 作为新增字段透传，不把 `route_contract_eof` 计作 `StreamComplete=true`。
|
||||
|
||||
### 4.5 宿主配置（Backend）
|
||||
|
||||
- 三个扁平设置键 `models.routeContractEOF.model`、`.baseUrl`、`.identitySha256`，在 `settings.Schema()` 中以 `Scope: SettingScopeSystem` 声明（`ManagedPaths` 会剥除并拒绝用户/项目层写入），画像覆盖不参与；任一为空 = 关闭（默认）。
|
||||
- `openLLMClient` 在实际解析出的 `(model, base)` 与配置三元组全部精确一致时才挂合同，按三元组判定、不看 `Kind`；轻量档、视觉改模、子代理按各自解析结果独立判断，不继承。全部调用点（`llm.go`、`sub_loop.go`、`squad_runner.go`、`verify.go`、`workflow_compiled.go`）统一经过同一判定。
|
||||
- 回滚：删除该设置键即恢复现行拒绝，无需发版；身份漂移（换模型、换基址）自动失效。
|
||||
|
||||
## 5. 风险与取舍
|
||||
|
||||
| 风险 | 处置 |
|
||||
|---|---|
|
||||
| 截断被误判为完成 | C4 要求 `finish_reason` 已到达；C2 要求传输按协议结束；C6 拒绝 `finish_reason` 之后再出现片段 |
|
||||
| 前提 ① 只部分满足（文档写明 `finish_reason` 非空即结束，但无 Usage 顺序与版本承诺） | 以精确身份绑定、默认关闭和 P1 付费探针兜底；P1 不通过即保持关闭 |
|
||||
| 供应商行为漂移、无版本承诺 | 合同只绑定精确身份；默认关闭；`ContractCheck` 使漂移在收据中可见；必要时直接删配置回滚 |
|
||||
| 参数语义错误进入执行 | C8 在放行前校验；registry 执行前再校验一次 |
|
||||
| `known_length` 是否纳入 | 方案纳入（仅 `match`）；r0.6 观察到的是 `http2_stream`。**请人审确认**是否只保留 `http2_stream` |
|
||||
| 两套 schema 校验漂移 | §4.3 提炼为单一函数 |
|
||||
|
||||
## 6. 需人审确认的取舍
|
||||
|
||||
1. C2 是否同时接受 `known_length`+`match`（建议接受），还是只接受 `http2_stream`。
|
||||
2. 宿主配置键仅系统层可写、默认关闭（建议如此）。
|
||||
3. 付费验证（1 次短工具探针 + 1 次 A01）在零付费部分合入后另提资源方案，不随本方案授权。
|
||||
@@ -0,0 +1,36 @@
|
||||
# 快慢通道 O2 I1（Agent-Native `route_contract_eof`）：阶段 6 评审包
|
||||
|
||||
- 状态：**用户阶段 6 通过（2026-10-20）**，接受第 3 节第 1 条的 C2 编号，并要求启动 I2。Agent-Native #48 已合入 main（`2fc66be`）。I3（Dev 改钉）待 I2 后启动，P1 付费探针另提资源方案。
|
||||
- 日期：2026-10-20；作者：host；Dev 任务：`feature/fast-slow-o2-i1-agent-native`。
|
||||
- 依据：[阶段 4 方案](2026-10-19-fast-slow-o2-route-contract-eof-design.md)与[阶段 5 计划 §2](../plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md)（用户 2026-10-20 通过；C2 同时接受 `http2_stream` 与 `known_length`+`match`）。
|
||||
- 交付对象：Agent-Native 草稿 PR [#48](https://git-home.u1680832.nyat.app:30319/weichen/Agent-Native/pulls/48)，base `9c24e22`（origin/main），head `899fd70`。
|
||||
|
||||
## 1. 交付内容
|
||||
|
||||
| 方案条目 | 实现 | 位置 |
|
||||
|---|---|---|
|
||||
| 路由合同与身份绑定（§4.1） | `RouteContractEOF{Model, BaseURL, IdentitySHA256}`、`RouteContractIdentity`、`NormalizeRouteBaseURL`（仅 https，含 userinfo/query/fragment 一律不匹配）；`Client.RouteContract` 为 nil/零值即关闭；重定向逐项比较 scheme、host、port、path | `runtime/llm/route_contract.go`、`client.go` |
|
||||
| 解析器延后判定（计划 §2.2） | 公开 `ParseSSE` 签名与零值行为不变；内部 `parseSSE(…, sseHooks)` 只在“有工具且缺 `[DONE]`”时把成功候选与今天的失败事件一起交给传输层；新增 `finishChunks`、`multiChoice`、`fragmentAfterFinish` 统计 | `runtime/llm/sse.go` |
|
||||
| 放行条件 C1–C9（§4.2） | 按顺序判定，记录第一个不满足的编号；放行时 `StreamComplete=false`、`CompletionBasis=route_contract_eof` | `route_contract.go` `check` |
|
||||
| 参数 schema 子集（§4.3） | 新包 `runtime/argschema.Validate`，由 `validateArgs`/`matchesType` 逐字迁移；registry 改为委托 | `runtime/argschema/`、`runtime/tools/registry.go` |
|
||||
| 可观测性（§4.4） | `Event.CompletionBasis`；`TerminalObservation.completionBasis`/`contractCheck`（仅枚举值）；`[DONE]` 成功路径记 `done_marker` | `types.go`、`client.go` |
|
||||
|
||||
## 2. 验证
|
||||
|
||||
- 实施：Cursor worker（`agent-exec`，attempt 2 success；attempt 1 因单元包 `allowed_paths` 误用 `**` 被判 scope-expansion，修正写法后经用户授权全新重跑），`agent-exec apply` 快进集成。
|
||||
- host 验证（SELF）@`899fd70`：改动文件 `gofmt` 合格；`git diff --check`；`go vet ./runtime/...`；`go test ./runtime/llm/... ./runtime/argschema/... ./runtime/tools/... -count=1`（另跑 `-race`）与 `go test ./... -count=1` 全部通过。
|
||||
- CI（GATE）：PR #48 head `899fd70` 三项检查 success（`ci / vet-and-test`、`ci / docker-checkout-hostgateway`、`governance / governance`）。
|
||||
- 独立 Review（全新会话 code-reviewer，只接收需求、base/head 与 diff；评审者自跑为 SELF）：**PASS，无阻塞项**。确认零值合同行为不变；拒绝事件与合同关闭事件除 `contractCheck` 外 `reflect.DeepEqual`；`argschema` 与旧实现逐行一致；无数据竞争；计划 §2 测试矩阵每一行都有带断言的用例，并同时断言 Usage 保留与放行次数。
|
||||
|
||||
## 3. 需人审确认与非阻塞项
|
||||
|
||||
1. **C3 行的编号差异**：计划写的是 HTTP/2 `RST_STREAM`/中途断连期望 C3，实现返回 **C2**。原因是 C2（传输边界）先于 C3 判定，断流时没有见到 EOF，先在 C2 失败。结论同样是拒绝，`contractCheck` 记录的是“第一个不满足的条件”，不一定是根因。请确认接受。
|
||||
2. **无工具的错误终态也会带 `contractCheck`**（非阻塞）：合同开启时，纯文本流遇到供应商错误这类终态也会补一次判定（如记为 `C2`），这类流本来就不可能放行。不影响验收条件 3，也不泄漏内容；可在后续把补判限定为含工具调用的终态。
|
||||
3. **重复 `finish_reason` 会被 C4 拒绝**（非阻塞，失败关闭）：若供应商在 usage 块里重复 `finish_reason`，一律拒绝。MiniMax 真实流是否这样，列为 P1 付费探针的观察点。
|
||||
4. **测试可加强**（非阻塞）：`release/http2` 与 `close-delimited` 用例可直接断言 `BodyBoundary.FramingClass`；补一个“合同开启时纯文本流不变”的回归用例（评审者已用临时探针确认行为不变）。
|
||||
|
||||
## 4. 下一步（通过后）
|
||||
|
||||
1. 合入 Agent-Native #48（组件仓，无需 #518 窗口）。
|
||||
2. 启动 I2（Backend：系统层配置键、`openLLMClient` 按身份挂合同、透传 `completionBasis`；启动前核对 Backend 是否有读 `StreamComplete` 的工具门控）。
|
||||
3. I3 Dev 改钉组合验证；P1 另提资源方案。
|
||||
@@ -0,0 +1,48 @@
|
||||
# 快慢通道 O2 I2（Backend `route_contract_eof` 配置与挂载）：阶段 6 评审包
|
||||
|
||||
- 状态：**用户阶段 6 通过（2026-10-20）**，并要求启动 I3。Backend #224 已合入 main（`c164950`）。P1 付费探针另提资源方案。
|
||||
- 日期：2026-10-20；作者：host；Dev 任务：`feature/fast-slow-o2-i2-backend`（Dev 草稿 PR [#652](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/652)）。
|
||||
- 依据：[阶段 4 方案 §4.5](2026-10-19-fast-slow-o2-route-contract-eof-design.md) 与[阶段 5 计划 §3](../plans/2026-10-19-fast-slow-o2-route-contract-eof-plan.md)；I1 已于 2026-10-20 通过，Agent-Native #48 合入 `2fc66be`。
|
||||
- 交付对象：Backend 草稿 PR [#224](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Backend/pulls/224)，base `b5eb89c`（origin/main），head `16f98b8`。
|
||||
|
||||
## 1. 交付内容
|
||||
|
||||
| 计划条目 | 实现 | 位置 |
|
||||
|---|---|---|
|
||||
| 改钉 Agent-Native | `deps/agent-native` `28f3ea7 → 2fc66be`（I1 合入点） | gitlink |
|
||||
| 系统层配置键 | `models.routeContractEOF.model/.baseUrl/.identitySha256`，`SettingScopeSystem`、缺省空；任一为空即关闭；用户/项目层写入被 `ManagedPaths` 剥除 | `internal/settings/settings.go` |
|
||||
| 按身份挂合同 | `routeContractFor(eff, route)`：三项非空、模型名精确相等、`NormalizeRouteBaseURL(route.Base)` 成功且等于配置值、`RouteContractIdentity` 等于摘要，全部满足才挂；只看本 client 实际解析出的 (model, base)，不看 `Kind` | `internal/runtime/llm.go` |
|
||||
| 5 个调用点全覆盖 | `llm.go`、`sub_loop.go`、`squad_runner.go`、`verify.go`、`workflow_compiled.go` 统一改用 `openRouteClient(route, eff)`；轻量档、视觉改模、子代理各自独立判定 | 同左 |
|
||||
| 运行记录透传 | Backend 包装器（`annotateKeyFailure`、`GuardProjectStream`、`budgetedStream` 等）原样转发事件，`CompletionBasis`/`TerminalObservation` 不丢；runmgr/store 本来不记录终态观测，无需改 | 测试断言 |
|
||||
| 快慢通道收据透传 | 评测工具按同一规则挂合同（导出薄封装 `runtime.RouteContractFor`）；受保护 route 文件可选 `routeContractEOF{…}` 移入系统层；`provider-records.json` 每条记录新增 `completionBasis`，`terminalObservation` 透传 `completionBasis`/`contractCheck`，均按枚举白名单（其它值记 `unknown`，空保持空） | `internal/server/work_checkpoint_eval_test.go`（`live` tag） |
|
||||
|
||||
## 2. 验证
|
||||
|
||||
- 实施：两个 Cursor worker 单元，均经 `agent-exec apply` 快进集成。
|
||||
- `o2-i2-backend-route-contract-config`：attempt 2 success（attempt 1 是 host 把写单元包与派发并行，导致 invalid-config）。
|
||||
- `o2-i2b-eval-receipt-route-contract`：补收据透传，attempt 2 success（attempt 1 因 Cursor CLI 连接中断记为 failed-unknown）。两次重跑均经用户授权。
|
||||
- host 验证（SELF）@`16f98b8`：
|
||||
- `gofmt`、`git diff --check`、`go vet ./internal/runtime ./internal/server`（含 `-tags live`）通过。
|
||||
- `go test ./internal/runtime ./internal/settings -count=1` 通过。
|
||||
- `go test -tags live ./internal/server` 新增 4 个 `TestEvalRouteContract*` 与既有 20 个评测预算/脱敏测试全部通过。
|
||||
- CI（GATE）：Backend CI 跑 `go vet ./... && go test ./...`。
|
||||
- `e1a90a5` 已 success。
|
||||
- `16f98b8` success（`ci / vet-and-test` runs/4409、`governance` runs/4410）。
|
||||
- **`live` tag 的评测测试不在 CI 内**，这部分只有 SELF 和独立评审重放。
|
||||
- 独立 Review（全新会话，只接收需求、base/head 与 diff）：
|
||||
- 第 1 轮 @`e1a90a5`：PASS-with-fixes。5 条单元验收满足；指出计划 §3 的“快慢通道收据透传”缺失，由第二个单元补齐。
|
||||
- 第 2 轮 @`16f98b8`：**PASS，无阻塞项**。确认生产代码零行为变化，评测判定经真实 settings 服务与生产同源，白名单无泄漏，不匹配时失败关闭，既有断言未删减；评审者重放 `live` 评测测试与 runtime 测试均通过（REPLAY）。
|
||||
|
||||
## 3. 需人审确认与非阻塞项
|
||||
|
||||
1. **小队 agent-native 内核不挂合同**（非阻塞，失败关闭）：`internal/app/app.go:350` 用主模型路由直接构造 client，不在计划列出的 5 个调用点内，行为维持今天的拒绝。若希望小队路径也享受合同放行，需另开增量。
|
||||
2. **意图生成器无合同**（无影响）：`app.go:519` 不涉及工具放行。
|
||||
3. **调用点接线靠审读确认**（非阻塞）：测试注入 `Stream`，没有直接执行 `Execute` 的 nil-stream 分支；判定函数与包装器透传均有直接测试。
|
||||
4. **`baseUrl` 说明措辞**（非阻塞）：只写了“无查询串”，未提 fragment/userinfo 同样不匹配。
|
||||
5. **评测配置写错时静默无合同**（非阻塞，建议 P1 前处理）：route 文件写了 `routeContractEOF` 但与路由不匹配时，评测按“无合同”运行（安全），但可能白花一次付费请求才发现。建议在 P1 资源方案前，把这种情况改为直接失败，且报错不带配置值。
|
||||
|
||||
## 4. 下一步（通过后）
|
||||
|
||||
1. 合入 Backend #224（组件仓，无需 #518 窗口）；Dev #652 收口合入。
|
||||
2. 启动 I3：Dev 改钉 Agent-Native `2fc66be` 与 Backend 合入点，`make test` 组合验证，经 #518 窗口合入。
|
||||
3. P1 付费探针另提资源方案（预算上限、停止条件、收据路径）并单独批准；在此之前不写任何实例的系统层配置。
|
||||
+1
-1
Submodule modules/backend updated: c8b1b7eb46...d8923f18ec
+1
-1
Submodule modules/frontend updated: dab16052cf...d7768d4ea0
+33
-10
@@ -73,18 +73,19 @@
|
||||
[AGENT-EXECUTION.md](../AGENT-EXECUTION.md) 为唯一权威；按角色声明的候选顺序在新进程与
|
||||
隔离工作区中尝试外部 Agent。不得跨单元复用同一外部进程，也不得 resume 同一次尝试。
|
||||
|
||||
实施、修复与测试的正常候选只有 Cursor、Antigravity（`agy`）和 PI。每个候选对安全可恢复失败
|
||||
最多 3 次全新尝试：`unavailable`，或外部无副作用已被机制证明的 `failed-clean`。三次仍属这类失败后才进入
|
||||
下一候选。单元包的 `network=false` 与 `external_cost=false` 只是声明，不证明外部干净；当前没有强制的
|
||||
实施、修复、测试与 Review 的候选为 Cursor、Antigravity（`agy`）、PI（GLM 与 MiniMax 两个档）和
|
||||
Codex。每个候选对安全可恢复失败最多 3 次全新尝试：`unavailable`，或外部无副作用已被机制证明的
|
||||
`failed-clean`。三次仍属这类失败后由控制器自动进入下一候选，host 不为此询问用户。
|
||||
单元包的 `network=false` 与 `external_cost=false` 只是声明，不证明外部干净；当前没有强制的
|
||||
网络/外部费用隔离或可信对账，所以已启动的失败尝试即使私有克隆可精确恢复，也记为 `failed-unknown`
|
||||
并保留现场。三个正常候选都安全耗尽后，才允许一次全新的 Codex CLI 紧急尝试；这次不按每候选 3 次计算。
|
||||
紧急尝试若仍是安全可恢复失败，运行停在 `blocked`。host 不接过该单元继续撰写。
|
||||
并保留现场。
|
||||
|
||||
Codex 平时只用于规划、方案设计、实施计划，或独立 Review。执行配置没有单独的 plan 角色；
|
||||
上述规划与设计工作可以直接使用 Codex CLI。`review` 角色的候选可以包含 Codex，并按该角色自己的
|
||||
顺序和尝试上限执行。Codex 不出现在实施、修复、测试的正常候选里；这三个角色上的一次紧急尝试是唯一例外。
|
||||
Codex 之外的候选顺序可按角色在 [AGENT-EXECUTION.md](../AGENT-EXECUTION.md) 中调整，但 Codex
|
||||
必须是每个角色的最后一个候选，不设单次紧急尝试。全部候选安全耗尽后运行停在 `unavailable` 或
|
||||
`blocked`，host 暂停该单元并询问用户是否重试，不接过该单元继续撰写。Codex 另可直接用于规划、
|
||||
方案设计、实施计划（执行配置没有单独的 plan 角色）。
|
||||
|
||||
显式 fail-stop 立即停止整次运行，不重试、不换候选、不启动紧急尝试：`failed-unknown`、
|
||||
显式 fail-stop 立即停止整次运行，不重试、不换候选：`failed-unknown`、
|
||||
`scope-expansion`、`blocked`、`cancelled`、无效配置、未对账的 Git 状态与安全失败。总超时，
|
||||
以及 stdin/stdout/stderr 都没有活动的空闲超时，归入 `failed-unknown`。
|
||||
|
||||
@@ -123,7 +124,7 @@ host 可以直接编写并提交的豁免只有 `.task/**`、`docs/superpowers/s
|
||||
`docs/superpowers/plans/**`。除此之外，host 不直接撰写实施单元。
|
||||
|
||||
安全耗尽不发出 `host-fallback-authorized`，`host_fallback_authorizations` 保持为 0。
|
||||
未配置紧急候选时终态为 unavailable 或 blocked，不授权 host 撰写实施单元。现行
|
||||
安全耗尽的终态为 unavailable 或 blocked，不授权 host 撰写实施单元。现行
|
||||
[AGENT-EXECUTION.md](../AGENT-EXECUTION.md) 的 `fallback_to_host` 是 `never`。旧值
|
||||
`all-unavailable` 仍可解析，但同样不产生 host 撰写授权。已归档任务卡里的旧表述保持原样，
|
||||
不改写成现行规则。
|
||||
@@ -461,3 +462,25 @@ post-merge 默认只提示，不因 pull 或 merge 自动提交、推送或创
|
||||
|
||||
中断或交接时记录当前有效版本、批准范围、未决假设、最新试验结论、剩余事项及下一动作。
|
||||
恢复后核对现场和授权，从最早未满足的环节续办；不重做仍有效的工作，不省略失效环节。
|
||||
|
||||
### 对话收尾交接块
|
||||
|
||||
每次结束用户任务时，最终对话回复的末尾都附一个简短、自包含的交接块，让对话上下文被清空后，
|
||||
新会话只读这一块和其中的链接就能续办。交接块只是对话层的摘要：权威仍然是任务卡、持久阶段交接
|
||||
（见[有界单元包、上下文与阶段交接](#有界单元包上下文与阶段交接)）和 evidence 记录。交接块不替代
|
||||
这些记录或证据，不得把仅写在回复里的内容声称为已记录、已验证，不手抄命令输出，二者不一致时以
|
||||
任务记录为准。
|
||||
|
||||
交接块只写续办所需的最少字段，没有的内容不编造：
|
||||
|
||||
- **目标与授权范围**：本次目标、已授权的动作与写入对象、交付终点。
|
||||
- **当前状态**：已完成、进行中、阻塞或放弃；有仓库时写仓库、分支、HEAD SHA，以及 PR 和任务卡路径。
|
||||
- **关键决定**：影响后续工作的取舍及其依据。
|
||||
- **变更文件**：路径列表，或写明无变更。
|
||||
- **验证与证据状态**：执行过的检查及结果，标注 `SELF`/`GATE`/`REPLAY`，并指向任务卡里的 evidence
|
||||
记录；没有执行的写 `NOT_RUN`，无法复核的写 `[未经证实]`。
|
||||
- **未决事项**：阻塞、待决策点、已登记的非阻塞项。
|
||||
- **下一动作**：一条明确的下一步，或明确写出“已完成，无后续”。
|
||||
|
||||
没有仓库变更、也没有续办状态的工作（例如纯问答或只读解释），只写一行明确的不适用交接，例如
|
||||
`交接：不适用（无仓库变更、无续办状态）`，不为凑齐字段而填充内容。
|
||||
|
||||
@@ -11,12 +11,12 @@
|
||||
### Agent 实施收据与来源
|
||||
|
||||
每次外部实施尝试须在任务卡「Agent 实施收据」记录：配置摘要（`AGENT-EXECUTION.md` digest）、
|
||||
角色、声明候选顺序、attempt、CLI/模型、终态、transport、fallback（只表示该行是否为 Codex
|
||||
紧急尝试），以及源码外原始收据路径。初始生成状态为 `NOT_RUN`。原始事件流与超限输出保留在
|
||||
角色、声明候选顺序、attempt、CLI/模型、终态、transport、fallback（是否为应急尝试；现行配置无
|
||||
应急档，恒为否），以及源码外原始收据路径。初始生成状态为 `NOT_RUN`。原始事件流与超限输出保留在
|
||||
源码外；未知终态（`failed-unknown`）与 `scope-expansion` 的隔离工作区须保留待对账，不得静默丢弃。
|
||||
清理须有精确恢复或保留现场的可复核证据。
|
||||
|
||||
候选、尝试上限、Codex 紧急尝试、fallback、fail-stop、尝试结束条件，以及 transport/admit
|
||||
候选、尝试上限、fallback、fail-stop、尝试结束条件，以及 transport/admit
|
||||
与 host 豁免路径，以[迭代交付](delivery.md#agent-实施单元与主模型职责)为唯一权威。
|
||||
|
||||
## 启动与恢复
|
||||
|
||||
@@ -14,7 +14,7 @@
|
||||
| A5 回收 | 本地命令检查；写者退出须可证明，无法证明时才请求 owner 决策 | 登记根目录、锁/操作状态、父子仓与唯一文件、合入核验 | `tests/test_task.py` |
|
||||
| A6 秘密 | 本地脱敏及 CI 获取边界；权限与宿主隔离另验 | 命令/输出/摘要脱敏，凭据不持久写 Git 配置 | `tests/test_evidence.py`、`tests/test_ci_credentials.py` |
|
||||
| A7 证据 | 本地 SELF 收据；外部来源独立核验 | 首次捕获、完整脱敏输出/摘要、对象记录、原样导入 | `tests/test_evidence.py`；CI/审阅链接另核 |
|
||||
| A8 阶段记录与迭代 | goal-first + agent-per-unit（AGENT-EXECUTION.md）；模板默认连续执行，仅真实决策点需人工，没有全流程授权强制；实施/修复/测试仅 Cursor、agy、PI，每候选对安全可恢复失败最多 3 次全新尝试，全部安全耗尽后一次 Codex CLI 紧急尝试；Codex 平时仅规划、设计、计划或独立 Review；显式 fail-stop 立即停止；不限制推理时长、工具次数、规划方式或首次写文件时间；集成经成功 transport 的 agent-exec apply，或 pre-commit admit 精确内容来源；host 豁免仅为 .task/** 与 docs/superpowers/specs/**、plans/**；host 不直接实施；fallback_to_host 为 never；安全耗尽不发出 host-fallback-authorized，终态为 unavailable 或 blocked | policy/delivery.md、AGENT-EXECUTION.md；任务卡分别记录阶段状态、决策点、Agent 实施收据（配置摘要/角色/候选/attempt/CLI-模型/终态/transport/紧急尝试/源码外路径）、Review、冲突、当前 HEAD 的 CI 和合入；post-merge 默认仅提示 | `tests/test_task.py` 核对 goal-first/agent-per-unit 模板、正常路由、尝试上限、fail-stop、空闲超时与 apply/admit 来源表述，及钩子不自动写入；`scripts/agent-exec validate`（CI）与 parser·adapter·controller 假 CLI 契约（Development-Manager internal/agentexec 测试，经 deps/development-manager 钉住）为本地 SELF 强制行为；已安装 provider/model 身份待 U5，远端平台准入为 GATE；智能体核对授权范围、实施单元边界、Review、冲突及匹配 HEAD 的 CI/平台准入 |
|
||||
| A8 阶段记录与迭代 | goal-first + agent-per-unit（AGENT-EXECUTION.md）；模板默认连续执行，仅真实决策点需人工，没有全流程授权强制；实施/修复/测试/Review 候选为 Cursor、agy、PI（GLM、MiniMax）与最后的 Codex，每候选对安全可恢复失败最多 3 次全新尝试并自动换候选，全部安全耗尽后暂停询问用户是否重试；显式 fail-stop 立即停止；不限制推理时长、工具次数、规划方式或首次写文件时间；集成经成功 transport 的 agent-exec apply，或 pre-commit admit 精确内容来源；host 豁免仅为 .task/** 与 docs/superpowers/specs/**、plans/**；host 不直接实施；fallback_to_host 为 never；安全耗尽不发出 host-fallback-authorized，终态为 unavailable 或 blocked | policy/delivery.md、AGENT-EXECUTION.md；任务卡分别记录阶段状态、决策点、Agent 实施收据（配置摘要/角色/候选/attempt/CLI-模型/终态/transport/fallback/源码外路径）、Review、冲突、当前 HEAD 的 CI 和合入；post-merge 默认仅提示 | `tests/test_task.py` 核对 goal-first/agent-per-unit 模板、正常路由、尝试上限、fail-stop、空闲超时与 apply/admit 来源表述，及钩子不自动写入；`scripts/agent-exec validate`（CI）与 parser·adapter·controller 假 CLI 契约（Development-Manager internal/agentexec 测试，经 deps/development-manager 钉住）为本地 SELF 强制行为；已安装 provider/model 身份待 U5，远端平台准入为 GATE；智能体核对授权范围、实施单元边界、Review、冲突及匹配 HEAD 的 CI/平台准入 |
|
||||
| A9 长期方向与后续任务 | manual；模板不校验规划有效性或自动调度任务 | policy/delivery.md；PROJECT.md 提供规划入口，任务卡关联规划/里程碑并记录下一步建议 | `tests/test_task.py` 核对生成字段与未授权默认值；智能体核对当前规划、进展、重复任务和建议依据，新任务仍不自动获得授权 |
|
||||
| A10 交付窗口 | manual；无自动互斥或接管 | [合入调度](delivery.md#合入调度)与 #518：同一目标一个最终窗口，等待分支不追 main；轮到后同步、固定、验证并由智能体合入 | 每个实际 PR 核对窗口记录、精确 HEAD 三项 GATE、Review 和合入后 main；不要求额外试行或全写者审计 |
|
||||
| A11 固定后证据 | manual 选择源码外位置；工具捕获绝对未用路径/原始输出；无 OS 冻结 | policy/governance.md；RECEIPT 捕获，后续授权闭合再原样导入 | `tests/test_evidence.py` 固定对象、权限、覆盖拒绝、原样导入与幂等 |
|
||||
|
||||
+5
-5
@@ -449,14 +449,14 @@ EOF
|
||||
- mock 档不支持；PG 档须有有效 DSN/dbref
|
||||
|
||||
五个子命令（经 scripts/svc.sh <env> user … 转发到实例二进制）：
|
||||
scripts/svc.sh <env> user create --owner <login> [--role user|admin] --out <0600新文件>
|
||||
scripts/svc.sh <env> user initialize-account --user-id <稳定ID> --expected-state-version <版本> --expected-generation <代数> --out <0600新文件>
|
||||
scripts/svc.sh <env> user create --owner <login> [--role user|admin]
|
||||
scripts/svc.sh <env> user initialize-account --user-id <稳定ID> --expected-state-version <版本> --expected-generation <代数>
|
||||
scripts/svc.sh <env> user list
|
||||
scripts/svc.sh <env> user revoke-login-key --id <key-id>
|
||||
scripts/svc.sh <env> user bootstrap-admin --owner <login> --out <0600新文件>
|
||||
|
||||
旧 reset-password、issue-login-key 与带初始密码建号已关闭；本人恢复走管理员提案、
|
||||
目标本人已有可信密码会话确认。凭据只写新建的 0600 交付文件，不回显 stdout。
|
||||
旧 reset-password、issue-login-key 入口已关闭；账号由管理员在网页创建并下发初始密码，
|
||||
首次登录后必须修改。忘记密码时由管理员生成一次性口令（POST /api/admin/users/{owner}/one-time-password）。
|
||||
本帮助描述 U3 代码契约；真实账号操作与生产切换须另行授权。
|
||||
更完整说明：docs/svc.md、docs/svc-deploy/u1-instance-account-binding.md
|
||||
EOF
|
||||
@@ -2451,7 +2451,7 @@ agent_do_user() {
|
||||
local a
|
||||
case "${1:-}" in
|
||||
reset-password|issue-login-key)
|
||||
c_err "[$ENV_NAME] RECOVERY_CONTRACT_REPLACED：旧账号重置/签发入口已关闭；使用本人确认的恢复提案"
|
||||
c_err "[$ENV_NAME] RECOVERY_CONTRACT_REPLACED：旧账号重置/签发入口已关闭；请联系管理员生成一次性口令（POST /api/admin/users/{owner}/one-time-password）"
|
||||
return 2 ;;
|
||||
esac
|
||||
for a in "$@"; do
|
||||
|
||||
@@ -39,10 +39,11 @@ import (
|
||||
)
|
||||
|
||||
const (
|
||||
aliceOwner = "mi_alice"
|
||||
alicePass = "mi-alice-pass-1"
|
||||
rootPass = "mi-root-pass-1"
|
||||
httpWait = 15 * time.Second
|
||||
aliceOwner = "mi_alice"
|
||||
aliceInitialPass = "MiAliceInitPass123!"
|
||||
alicePass = "mi-alice-pass-1"
|
||||
rootPass = "mi-root-pass-1"
|
||||
httpWait = 15 * time.Second
|
||||
)
|
||||
|
||||
type instance struct {
|
||||
@@ -452,28 +453,35 @@ func (e *env) killNine(t *testing.T, inst *instance) {
|
||||
|
||||
// ---- HTTP 客户端 ----
|
||||
|
||||
// loginAlice 引导 alice 账号并发放 API key（CLI 直连测试库；key 存共享 PG，
|
||||
// 对两实例同时有效——程序化验收的首选凭证，SSE 亦可用 ?key= 兜底）。
|
||||
// U3 后本地无密码创建：user create 只签发待激活账号的一次性激活 Key（凭据
|
||||
// 独占落 JSON），redeem 会话进入 grant-setup 改密设 alicePass，完成后再发 Key。
|
||||
// loginAlice 由管理员创建 alice 初始密码账号，再登录并改密后发放 API key
|
||||
// （CLI 直连测试库；key 存共享 PG，对两实例同时有效——程序化验收的首选凭证，
|
||||
// SSE 亦可用 ?key= 兜底）。
|
||||
func (e *env) loginAlice(t *testing.T) *userClient {
|
||||
t.Helper()
|
||||
// 超级管理员 mi-root 已由 serve 启动时的 SUPER_ADMIN_* 建立；这里只建 alice，
|
||||
// 一次性激活凭据独占落临时 JSON。
|
||||
activation := filepath.Join(t.TempDir(), "activation.json")
|
||||
e.cliIn(t, e.a.dataDir, "user", "create", "--dsn", e.dbDSN, "--owner", aliceOwner, "--name", "Alice", "--out", activation)
|
||||
activateKey := activationSecret(t, activation)
|
||||
// 超级管理员 mi-root 已由 serve 启动时的 SUPER_ADMIN_* 建立；用 root key 走
|
||||
// admin API 创建 alice（带初始密码）。
|
||||
rootKey := e.cliOut(t, "apikey", "create", "--dsn", e.dbDSN, "--owner", "mi-root", "--name", "mi-acceptance-root-create-alice")
|
||||
root := &http.Client{Timeout: httpWait, Transport: bearerRT{key: rootKey}}
|
||||
e.do(t, root, "POST", "/api/admin/users", map[string]any{
|
||||
"owner": aliceOwner,
|
||||
"profile": map[string]any{
|
||||
"name": "Alice",
|
||||
},
|
||||
"password": aliceInitialPass,
|
||||
}, nil)
|
||||
jar, err := cookiejar.New(nil)
|
||||
if err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
sess := &http.Client{Timeout: httpWait, Jar: jar}
|
||||
// e.uc 尚未赋值 → baseFor 走 A；redeem 会话（grant-setup）直接设 alicePass。
|
||||
e.do(t, sess, "POST", "/api/auth/login-key/redeem", map[string]any{
|
||||
"key": activateKey,
|
||||
// e.uc 尚未赋值 → baseFor 走 A；初始密码登录后会话仅允许改密。
|
||||
e.do(t, sess, "POST", "/api/auth/login", map[string]any{
|
||||
"owner": aliceOwner,
|
||||
"password": aliceInitialPass,
|
||||
}, nil)
|
||||
e.do(t, sess, "POST", "/api/auth/password", map[string]any{
|
||||
"next": alicePass,
|
||||
"current": aliceInitialPass,
|
||||
"next": alicePass,
|
||||
}, nil)
|
||||
|
||||
apiKey := e.cliOut(t, "apikey", "create", "--dsn", e.dbDSN, "--owner", aliceOwner, "--name", "mi-acceptance")
|
||||
@@ -540,22 +548,6 @@ func (b bearerRT) RoundTrip(r *http.Request) (*http.Response, error) {
|
||||
return http.DefaultTransport.RoundTrip(r2)
|
||||
}
|
||||
|
||||
// activationSecret 读 CLI 凭据独占文件里的激活 Key（JSON {"kind","owner","secret"}）。
|
||||
func activationSecret(t *testing.T, path string) string {
|
||||
t.Helper()
|
||||
b, err := os.ReadFile(path)
|
||||
if err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
var v struct {
|
||||
Secret string `json:"secret"`
|
||||
}
|
||||
if err := json.Unmarshal(b, &v); err != nil || v.Secret == "" {
|
||||
t.Fatalf("activation credential unreadable: %v", err)
|
||||
}
|
||||
return v.Secret
|
||||
}
|
||||
|
||||
// cliOut 运行 CLI 并取 stdout 首行（apikey create 的明文仅此一次输出）。
|
||||
func (e *env) cliOut(t *testing.T, args ...string) string {
|
||||
t.Helper()
|
||||
|
||||
Reference in New Issue
Block a user