diff --git a/.task/archive/feature-genui-prod-upgrade-docsync.md b/.task/archive/feature-genui-prod-upgrade-docsync.md new file mode 100644 index 00000000..4ab8876f --- /dev/null +++ b/.task/archive/feature-genui-prod-upgrade-docsync.md @@ -0,0 +1,161 @@ +# feature/genui-prod-upgrade-docsync 任务卡 + +任务主记录：PR #679 https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/679；状态：已完成（合入前闭合）；owner：weichen + +## 基线与授权 + +- 权威仓：ssh://git@192.168.3.2:2222/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= e634608d97333354c3ead85d47c9e9e368a992a0 +- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-genui-prod-upgrade-docsync（worktree）；分支：feature/genui-prod-upgrade-docsync +- 分支类型：standalone；root_target：main；immediate_target：main；accepting_requirements：false +- 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=6f68e1ece9fe3a765dde7e98955e816bcb1e6c8f776739169191da3353604790；triage_receipt=/tmp/genui-prod-upgrade-doc/triage.json；receipt_sha256=52f7deacbc7f523892a5c6bdae42a3add141712558df706c9d93134ed7d32516 + +- 授权与交付终点：用户 2026-10-21 选择「升级生产并交给 svc 完整管理」。终点：prod 升级运行 + Documents #119 与本 PR 合入、任务收口。 +- 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进） +- 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md） +- 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入） +- 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收 +- 当前阶段：合入；当前增量：I1（升级运维 + 文档同步） +- 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位） + +## 目标与非目标 + +- 目标：本机 GenUI `prod`（127.0.0.1:8787，`pg1/prod`）由 `dev@b4649d7`（schema v25，无 identity 能力，svc 不能接管）升级至 `dev@5360884`（v51）并由主检出 `scripts/svc.sh` 完整管理；收口稿部署条目同步。 +- 仓外运维（不入仓，本卡记事实）：备份 `~/.local/share/agent-system-backups/genui-prod-upgrade-20261021T123748Z/`（prod.dump、prod-final.dump、prod-runtime.tar、保留目录整包 tar.gz）；演练实例 `prodrh`（库副本）完整走 adopt → migrate → deploy 并验证后清除；正式：停服 12:41:39 → 迁入 `runtime/prod` 并 bulk-set 重锚 → `adopt --confirm svc-prod-f29fb8e57420` → 候选二进制 `agent-system migrate` → `svc.sh prod deploy --from dev@5360884` → 12:42:39 UI 就绪。新增 `superadmin`（凭据 `runtime/prod/super-admin.env` 0600，经 `AGENT_SYSTEM_ENV_FILE` 传入）；原 `admin` 保留。保留目录打包后删除。 +- 非目标：GenUI 功能验收清单重跑（NOT_RUN）；svc.sh 改动。 + +## Agent 实施收据 + +路由与 fail-stop 规则见根目录 AGENT-EXECUTION.md 与 policy/delivery.md；每次尝试一行，原始日志留在源码外收据路径。 + +| 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 | +|---|---|---|---|---|---|---|---|---|---|---| +| documents-genui-prod-upgrade-docsync | Documents 收口稿单条目 | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto（fresh process） | success | applied → Documents 518e381（#119） | 无 | /tmp/genui-prod-upgrade-doc/docs-run.json | +| dev-genui-prod-upgrade-docsync-repin | modules/documents gitlink | AGENT-EXECUTION.md | implementation | cursor→antigravity→pi-glm→pi→codex | 1 | cursor / auto（fresh process） | success | applied → 137a18c | 无 | /tmp/genui-prod-upgrade-doc/dev-run.json | + +## 关联方向与规划 + +- 适用状态：待核对（无适用规划时说明原因） +- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文） +- 对应里程碑：待核对 + +## 需求分析 + +| ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 | +|---|---|---|---|---|---|---| +| R1 | 待填写 | 待评估 | 待定 | 待定义 | 待确认 | 待评审 | + +## 方案与计划 + +- 方案引用：待填写（含对象版本） +- 实施计划引用：待填写（含增量与需求 ID） +- 测试计划引用：待填写（含需求 ID 与验收条件） + +## 阶段记录 + +| 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 | +|---|---|---|---|---|---| +| 需求拆解 | 待定 | 待执行 | — | — | — | +| 需求评估 | 待定 | 待执行 | — | — | — | +| 需求表确认 | 待定 | 待执行 | — | — | — | +| 方案设计 | 待定 | 待执行 | — | — | — | +| 实施计划 | 待定 | 待执行 | — | — | — | +| 实施与自检 | 待定 | 待执行 | — | — | — | +| 正式测试与验收 | 待定 | 待执行 | — | — | — | +| 代码 Review | 待定 | 待执行 | — | — | — | +| 合入 | 待定 | 待执行 | — | — | — | +| 合入核验与收口 | 待定 | 待执行 | — | — | — | + +## 探索试验与迭代 + +| 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 | +|---|---|---|---|---|---|---|---| +| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 | + +## 同步记录 + +| 节点 | sync_base_sha | tested_head_sha | checked_at | +|---|---|---|---| +| 启动 | e634608d97333354c3ead85d47c9e9e368a992a0 | e634608d97333354c3ead85d47c9e9e368a992a0 | 2026-10-21T12:44:13Z | + +## 证据（Evidence） + + +| 时间(UTC) | 命令 | 被测HEAD | exit | 来源 | sha256(16) | +|---|---|---|---|---|---| + +## 交付调度 + +- 调度状态：未入队；调度记录：无 +- entry_id：无；attempt_id：无；窗口执行者：无 +- 固定候选：无（base/head、组件与相关配置引用实际尝试） +- 调度依据：policy/delivery.md#合入调度 +- 固定后证据：源码外 RECEIPT；实际结果后按授权原样导入和闭合 + +## 结果与验证 + +- 结果：prod 运行 `dev@5360884e`（svc 管理，desired=running，identity established，schema v51）；Documents #119 合入（merge 2e9c3bc）；`modules/documents` fcea466→2e9c3bc。 +- 验证：Documents #119 head 518e381 CI governance=success（GATE）；Dev 以本 PR 当前 HEAD 的 CI 为准。仓外运维 SELF：healthz/readyz/UI=200；superadmin 登录 200、isSuperAdmin=true；未登录 /api/me/profile=401；argv 无 DSN；users（admin、superadmin）与 3 个会话保留。GenUI 功能验收清单 NOT_RUN。 +- 影响与剩余项：停机约 1 分钟。svc 不持久化超级管理员凭据：`scripts/svc.sh prod start/restart`（含 recover/watchdog）须带 `AGENT_SYSTEM_ENV_FILE=runtime/prod/super-admin.env`，否则服务拒绝启动（与 dev 同）。发现（非阻塞，未修）：v27 前旧库经 svc 部署时身份门禁 ensure 报 identity table missing，须先手工 `agent-system migrate`；`svc.sh adopt` 在旧制品下实际保持 pending 却提示 established。 + +## 规划进展与下一步 + +- 本次推进/剩余：待核对（依据实际成果更新适用方案/规划） +- 首选下一任务：待核对（无适用规划、已完成或受阻时如实说明，不虚构任务） +- 推荐依据：待填写 +- 前置条件/待确认：待核对 +- 预期产物/验收条件：待定义 +- 重复任务核对：待核对（已有/在途任务、PR 与规划记录） +- 启动授权：未授权（建议不自动启动新任务，仍须明确授权） + +## 合入与清理 + +- Review 记录：NOT_RUN（审阅智能体/平台身份、base/head、结论、问题闭合及重放依据） +- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测） +- CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果） +- 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验） +- 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置） + + +```json +{ + "summary_schema": 1, + "source": "SELF", + "timestamp": "2026-10-21T12:43:34.416643+00:00", + "command": "make precheck", + "exit_code": 0, + "cwd": "/home/weichen/projects/Agent-System-Dev", + "before_head": "e634608d97333354c3ead85d47c9e9e368a992a0", + "after_head": "e634608d97333354c3ead85d47c9e9e368a992a0", + "branch": "main", + "target_branch": "main", + "target_head": "e634608d97333354c3ead85d47c9e9e368a992a0", + "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=e634608d97", + "[remote] origin/main=e634608d97 ahead=0 behind=0", + "[tree] clean submodules_drift=0 uninit=0", + "[worktrees] linked=3", + "[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] e634608d97（完整：e634608d97333354c3ead85d47c9e9e368a992a0）", + "[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": "780774c4e44bd6f550b9d22ee2db80a7ae56d999c3f130cec70d8845b21aff16", + "receipt_sha256": "da371db8c87cef44543025eedbc4f3112b08d6fd0478b4072a1590b844eb9618", + "receipt_path": "/home/weichen/.cache/agent-system-dev/evidence/da371db8c87cef44543025eedbc4f3112b08d6fd0478b4072a1590b844eb9618.json" +} +``` + +## 闭合记录（合入前折叠） + +- 本卡在 PR #679（https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/679）合入前闭合并归档，随该 PR 一同合入。 +- 该 PR 的合并提交即本任务的落地记录。 +- 合入后无需回填，也无需单独的闭合 PR。 diff --git a/modules/documents b/modules/documents index fcea4660..2e9c3bc1 160000 --- a/modules/documents +++ b/modules/documents @@ -1 +1 @@ -Subproject commit fcea46602b3f0e4113ff3baffbf7882b2dce37d9 +Subproject commit 2e9c3bc1d8be6079832dcc8a26ac1a0c01826e90