diff --git a/.task/feature-genui-prod-upgrade-docsync.md b/.task/feature-genui-prod-upgrade-docsync.md index a38460e7..0760666a 100644 --- a/.task/feature-genui-prod-upgrade-docsync.md +++ b/.task/feature-genui-prod-upgrade-docsync.md @@ -9,17 +9,19 @@ - 分支类型: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(待定义) +- 当前阶段:合入;当前增量: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 实施收据 @@ -27,7 +29,8 @@ | 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 | |---|---|---|---|---|---|---|---|---|---|---| -| 待定义 | — | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | — | +| 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 | ## 关联方向与规划 @@ -90,9 +93,9 @@ ## 结果与验证(完成后填写) -- 结果: -- 验证:<结论摘要 PASS/FAIL/SKIP/NOT_RUN 逐项;逐条证据由 make evidence 写入上方证据表> -- 影响与剩余项: +- 结果: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。 ## 规划进展与下一步