Agent-System-Dev/.task/feature-rdm-two-trees-followup.md

feature/rdm-two-trees-followup 任务卡

任务主记录：https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/635；状态：进行中；owner：weichen

基线与授权

• 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 46e331a7a8

• 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-rdm-two-trees-followup（worktree）；分支：feature/rdm-two-trees-followup

• 分支类型：initiative；initiative_id：feature-rdm-two-trees-followup；root_target：main；immediate_target：main；accepting_requirements：true

• 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=ec5195ceec26c05d94600716514c5f306bd3d2aba2a18e4e71f54a660e0b1b83；triage_receipt=/tmp/tt-followup-triage-20261019.json；receipt_sha256=3abe686c520606f4969e17668843666bfafc4cebd7f869995121ab82ed5dd345

• 授权与交付终点：用户 2026-10-19 在遗留项推进中选定“两棵树后续大任务”；本轮终点为建卡登记剩余项，并把第一个增量 A1（W0 清单守护 + svc 测试动态端口 + W3 余项差距核对）推进到阶段 6 评审包。manual 模式：每个增量须用户阶段 6 人审后才合入；未授权：Backend 发版/tag（X3 公开扩展接口，双钥匙由用户执行）、真实模型与付费请求（W11/W12 另提资源方案）、运行库迁移、部署。

• 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进）

• 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md）

• 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入）

• 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收

• 当前阶段：A1、W3 余项、增量 B（W5/W6/W7a）均通过阶段 6 并合入本分支；下一增量：C（W8/W10，待登记）；W7 provider 接线等 X1 tag（用户双钥匙）

• 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位）

目标与非目标

章程（charter）

用途与目标：承接 .task/archive/feature-rdm-two-trees-latest-templates.md（部分收口，Dev #630）未交付部分，按已批准的阶段 4 方案与阶段 5 计划 r1（modules/documents/docs/records/2026-10-14-rdm-two-trees-latest-templates/rdm-two-trees-stage5-implementation-test-plan-r1.md 与 work-observation 增补计划 r1）完成两棵树一网的模板、递归实例、追溯、上下文、审计与正式界面。

接纳范围：W0（DHF 清单守护，原分支 9873a55 未合入部分）、svc 测试动态端口修复、W3 余项（旧数据迁移等，见 A1 差距核对）、W5 追溯网、W7 上下文提供方、W8 RDM 审计投影、W10 正式前端、W11 DHF 全量保真、W12 含真实模型全组合验收、W13 收口，以及 X3/R3/F3/V3 产品链。

非目标：IAM 项目协作与联动权限（feature-iam-role-permission-linked-capabilities 范围）；重新设计已批准方案；未经单独授权的发版、迁移、部署与付费请求。

分级测试策略：每增量 SELF 定向测试 + 独立 Review → 用户阶段 6 人审 → PR CI（GATE）；阶段 7 只在全目标候选固定后正式验收。

生命周期：增量 A1 → 用户阶段 6 → 后续增量按原计划 B（W5–W7）、C（W8–W10）、D（W11/W12）推进；X3 发版与 W11/W12 资源各自单独授权。

子任务登记

子任务分支	必需	状态	PR
A1：W0 守护 + svc 动态端口 + W3 差距核对（本分支内增量）	是	已合入（本分支 000a2d2；用户 2026-10-19 阶段 6 通过）	本分支 PR #635（草稿，initiative 收口时合入 main）
feature/rdm-two-trees-followup-w3-rest	是	已合入（用户 2026-10-20 阶段 6 通过；W3 余项：迁移两次同值、图形不透明块、移动/改名引用、旧批准版回取、重复表格复核；评审包 docs/superpowers/specs/2026-10-19-rdm-two-trees-followup-w3-review.md）。前置条件：W4 开放结构写入口前先补节点种类放置检查；Dev 的 RDM gitlink 改钉在 initiative 收口时统一组合验证	RDM PR #451（合入 RDM main 76b4c05）；本子任务 PR #641
feature/rdm-two-trees-followup-w5-w7（增量 B：W5/W6/W7a）	是	已合入（用户 2026-10-20 阶段 6 通过：W5 追溯网领域核+命令面、W6 X1 恢复并按批准修订补齐、W7a 纯领域 bundle；独立 Review RDM 0 BLOCKING/6 MAJOR 已修复、Backend 7/7 PASS；评审包 docs/superpowers/specs/2026-10-20-rdm-two-trees-followup-w5-w7-review.md）。W7 provider 接线等 X1 tag（用户双钥匙）；Backend MINOR 6 条随接线处理；RDM MINOR 14 条为增量 C 顺手项	RDM PR #458（合入 RDM main 93badd7e）；本子任务 PR #666；Backend PR #231（合入 backend main 7a41f22e）
B：W5/W7	是	待登记	—
C：W8/W10	是	待登记	—
D：W11/W12/W13	是	待登记（需资源方案）	—
X3/R3/F3/V3	是	待登记（X3 需 Backend 发版，双钥匙）	—

Agent 实施收据

路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。

单元 ID	预期范围	配置摘要	角色	候选顺序	attempt	CLI/模型	终态	transport	fallback	源码外收据路径
two-trees-followup-a1-w0-guard-and-svc-ports	scripts/dhf_catalog_guard.py、tests/test_dhf_catalog_guard.py、tests/test_svc.py、tests/test_svc_recover.py、tests/test_svc_realcombo.py	config ccf5b7c03ce4；unit 6fe9be3e5516	implementation	cursor → agy → pi	1（9075eee055af，fresh_session）	cursor	success	apply ff 8cf4619..000a2d2	未触发	/tmp/leftover-20261019/tt-a1-receipt.json（run b7a8e78a2b6d0d8f6803490c7fa8af2e）

关联方向与规划

• 适用状态：适用
• 主记录路径/版本：.task/archive/feature-rdm-two-trees-latest-templates.md；modules/documents/docs/records/2026-10-14-rdm-two-trees-latest-templates/（阶段 4 方案、阶段 5 计划 r1）
• 对应里程碑：两棵树一网与 DHF 模板（阶段 6 增量 A–D）

需求分析

ID	描述	项目符合度及依据	优先级	验收条件	依赖	结论
R1	W0 DHF 清单守护落地 main	符合：阶段 5 计划 W0；原实现 38ef548 曾 SELF 通过与限域复审	P1	守护单测通过；不宣称任何模板 published	DHF catalog	纳入 A1
R2	svc 测试动态端口	符合：并发 worktree 固定端口误入占用路径（cabac58 证据）	P2	原断言保留；test_svc/test_svc_recover 通过	无	纳入 A1
R3	W3 余项差距核对	符合：W3 递归节点主体已在 RDM main（8dd8ebe）	P1	逐项列出已交付/缺失与证据	RDM main	纳入 A1（仅核对）

方案与计划

• 方案引用：阶段 4 方案 rdm-two-trees-stage4-design-r1.md（已批准）
• 实施计划引用：rdm-two-trees-stage5-implementation-test-plan-r1.md（已批准）W0/W3；A1 评审包见 docs/superpowers/specs/2026-10-19-rdm-two-trees-followup-a1-review.md
• 测试计划引用：同上计划 W0/W3 验证节；A1 定向单测

阶段记录

阶段	对象版本	状态	决策/执行者	时间	依据
需求拆解	R0 46e331a	完成	host	2026-10-19	承接部分收口剩余项
需求评估	待定	待执行	—	—	—
需求表确认	待定	待执行	—	—	—
方案设计	阶段 4 r1	沿用已批准方案	用户（原任务）	2026-10-14	原卡阶段记录
实施计划	阶段 5 r1	沿用已批准计划	用户（原任务）	2026-10-14	原卡阶段记录
实施与自检	A1 000a2d2	完成（SELF）	cursor worker 实施；host 范围审阅与定向单测	2026-10-19	收据 tt-a1-receipt.json；67 测试 OK（skipped=16 为真实二进制 NOT_RUN）
阶段 6 人审	A1 679da1a（CI GATE success，test-pg 偶发失败后重跑通过）	通过	用户	2026-10-19	docs/superpowers/specs/2026-10-19-rdm-two-trees-followup-a1-review.md
正式测试与验收	待定	待执行	—	—	—
代码 Review	待定	待执行	—	—	—
合入	待定	待执行	—	—	—
合入核验与收口	待定	待执行	—	—	—

探索试验与迭代

增量/试验	假设	范围	判断和停止条件	授权/决策依据	结果	变更影响	需重审补测
A1	原 W0/端口修复在最新 main 上可最小适配重新落地	Dev scripts/tests	定向单测通过；原断言不删减；不适配则停止并报告	用户 2026-10-19 选定	守护脚本与单测按 9873a55 原样落地；端口修复按 cabac58 意图在最新 main 重新实现（原补丁不可直接应用），原断言一一改用分配端口未删减；W3 差距见评审包	仅测试与守护脚本	阶段 6 已通过

同步记录

节点	sync_base_sha	tested_head_sha	checked_at
启动	46e331a7a8	46e331a7a8	2026-10-19T14:38:46Z

证据（Evidence）

时间(UTC)	命令	被测HEAD	exit	来源	sha256(16)

交付调度

• 调度状态：未入队；调度记录：无
• entry_id：无；attempt_id：无；窗口执行者：无
• 固定候选：无（base/head、组件与相关配置引用实际尝试）
• 调度依据：policy/delivery.md#合入调度
• 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合

结果与验证（完成后填写）

• 结果：A1 实施完成（000a2d2），评审包已提交，等待用户阶段 6 人审；未合入。
• 验证：定向单测 PASS（SELF，67 测试，skipped=16 为真实二进制 NOT_RUN）；PR CI（GATE）见合入与清理节；W3 差距为关键字级 SELF。
• 影响与剩余项：仅 Dev 测试与守护脚本；剩余项见评审包第 3 节（W3 余项、B、C、D、X3 链）。

规划进展与下一步

• 本次推进/剩余：A1、W3 余项已验收；剩余 B（W5/W7）、C（W8/W10）、D（W11–W13）、X3 产品链
• 首选下一任务：B（W5 追溯网 / W7 上下文提供方）子任务登记
• 推荐依据：W3 余项已于 2026-10-20 通过阶段 6；B/C 依赖 W3/W4 稳定
• 前置条件/待确认：W4 开放结构写入口前须先补节点种类放置检查（W3 评审非阻塞项 1，用户确认）；RDM 文件与 IAM link（RDM iam-link-u2）可能重叠，启动前核对
• 预期产物/验收条件：按阶段 5 计划 W5/W7 验证节
• 重复任务核对：启动前核对
• 启动授权：待用户确定

合入与清理

• Review 记录：NOT_RUN（审阅智能体/平台身份、base/head、结论、问题闭合及重放依据）
• 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测）
• CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果）
• 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验）
• 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）

{
  "summary_schema": 1,
  "source": "SELF",
  "timestamp": "2026-10-19T14:37:49.134350+00:00",
  "command": "make precheck",
  "exit_code": 0,
  "cwd": "/home/weichen/projects/Agent-System-Dev",
  "before_head": "46e331a7a81c94c6f5881c997ae0aca45664c830",
  "after_head": "46e331a7a81c94c6f5881c997ae0aca45664c830",
  "branch": "main",
  "target_branch": "main",
  "target_head": "46e331a7a81c94c6f5881c997ae0aca45664c830",
  "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=46e331a7a8",
    "[remote] origin/main=46e331a7a8 ahead=0 behind=0",
    "[tree]   clean submodules_drift=0 uninit=0",
    "[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] 46e331a7a8（完整：46e331a7a81c94c6f5881c997ae0aca45664c830）",
    "[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": "6cba29f361cd5d6ad7c8712594c53dd0899e10d1d89a2b510a8e85522b461cfa",
  "receipt_sha256": "17f97ec95374ca86a9e49b4b7976cf318ae1f7ae5052d8a746ab219907e1be4c",
  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/17f97ec95374ca86a9e49b4b7976cf318ae1f7ae5052d8a746ab219907e1be4c.json"
}

{
  "summary_schema": 1,
  "source": "SELF",
  "timestamp": "2026-10-19T15:01:26.746182+00:00",
  "command": "python3 -m unittest tests.test_dhf_catalog_guard tests.test_svc tests.test_svc_recover tests.test_svc_realcombo",
  "exit_code": 0,
  "cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-rdm-two-trees-followup",
  "before_head": "000a2d2ae0e29fecd42ff19bf2b42e430be22ef8",
  "after_head": "000a2d2ae0e29fecd42ff19bf2b42e430be22ef8",
  "branch": "feature/rdm-two-trees-followup",
  "target_branch": "main",
  "target_head": "2b7fdc39a1f44163f4766701429d61ffd6926f1a",
  "root_target": "main",
  "immediate_target": "main",
  "before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "output_tail": [
    ".........................[main 579aaee] rdm v2",
    " 1 file changed, 1 insertion(+)",
    " create mode 100644 marker",
    "To /tmp/svc-db-regress-m9jw7ip3/rdmremote.git",
    "   526900c..579aaee  main -> main",
    "..........................ssssssssssssssss",
    "----------------------------------------------------------------------",
    "Ran 67 tests in 44.079s",
    "",
    "OK (skipped=16)"
  ],
  "output_sha256": "cdf6732fa953eedac3fcea3f5d042c64a3d16c93a94f76308a212256b05b75e2",
  "receipt_sha256": "4642350698dad77b3ab2397ef089219380651672d7f76113650d942b31b2df7a",
  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/4642350698dad77b3ab2397ef089219380651672d7f76113650d942b31b2df7a.json"
}

| 同步（记录前对象） | 2b7fdc39a1 | 26e4ea6391 | 2026-10-19T15:05:52Z |

{
  "summary_schema": 1,
  "source": "SELF",
  "timestamp": "2026-10-19T15:06:00.721625+00:00",
  "command": "python3 -m unittest tests.test_dhf_catalog_guard tests.test_svc tests.test_svc_recover tests.test_svc_realcombo",
  "exit_code": 0,
  "cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-rdm-two-trees-followup",
  "before_head": "dd2f8b1f240a74a0f467533512b88da541c19999",
  "after_head": "dd2f8b1f240a74a0f467533512b88da541c19999",
  "branch": "feature/rdm-two-trees-followup",
  "target_branch": "main",
  "target_head": "2b7fdc39a1f44163f4766701429d61ffd6926f1a",
  "root_target": "main",
  "immediate_target": "main",
  "before_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "after_tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "output_tail": [
    ".........................[main e5428ad] rdm v2",
    " 1 file changed, 1 insertion(+)",
    " create mode 100644 marker",
    "To /tmp/svc-db-regress-e8y1ohso/rdmremote.git",
    "   d78f4bf..e5428ad  main -> main",
    "..........................ssssssssssssssss",
    "----------------------------------------------------------------------",
    "Ran 67 tests in 41.981s",
    "",
    "OK (skipped=16)"
  ],
  "output_sha256": "ea93eda4d2d37fcbe97d826cdda982a1a9274f27284dd7a930d09117de251e04",
  "receipt_sha256": "0279d9b351beb2e54b662d4bc98b2b492c3898e931bd2a995ddb31c3e70f0fdb",
  "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/0279d9b351beb2e54b662d4bc98b2b492c3898e931bd2a995ddb31c3e70f0fdb.json"
}

| 同步（记录前对象） | 7e6c544b3c | 8562424278 | 2026-10-20T11:41:24Z | | 同步（记录前对象） | 33d6ef6921 | 1b286ec3e6 | 2026-10-22T06:35:19Z |