From 20f09f0b73fda9165d4875b784e095ed127293c2 Mon Sep 17 00:00:00 2001 From: gewuyou <95328647+GeWuYou@users.noreply.github.com> Date: Thu, 14 May 2026 10:40:31 +0800 Subject: [PATCH] =?UTF-8?q?docs(cqrs-rewrite):=20=E6=94=B6=E5=8F=A3PR351?= =?UTF-8?q?=E6=81=A2=E5=A4=8D=E5=85=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 更新 active tracking 到 PR #351 的当前审查真值与最小恢复入口 - 修复 active tracking 中过期 PR 锚点与冲突事实 - 重构 active trace 为精简恢复摘要并保留 archive 指针 - 补充本轮 PR review、license header、diff check 与 Release build 验证结果 --- .../todos/cqrs-rewrite-migration-tracking.md | 116 ++-- .../traces/cqrs-rewrite-migration-trace.md | 522 ++---------------- 2 files changed, 110 insertions(+), 528 deletions(-) diff --git a/ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md b/ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md index 39c347f9..1499c06f 100644 --- a/ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md +++ b/ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md @@ -12,91 +12,74 @@ CQRS 迁移与收敛。 ## 当前恢复点 -- 恢复点编号:`CQRS-REWRITE-RP-143` +- 恢复点编号:`CQRS-REWRITE-RP-144` - 当前阶段:`Phase 8` -- 当前 PR 锚点:`PR #350(MERGED,2026-05-13)` +- 当前 PR 锚点:`PR #351(OPEN,2026-05-14)` - 当前结论: - - 在用户允许 subagent 后,本轮按 `context-budget 优先、reviewability 次之、50 files 仅作粗阈值` 重开了一波小型 multi-agent 批处理, - 只接受单文件或窄文件组的 docs/test 切片。 - - 已接受的低风险切片: - - `GFramework.Cqrs.Benchmarks/Messaging/RequestLifetimeBenchmarks.cs` - - 修正两处 XML 文档缩进异常 - - `GFramework.Cqrs.Benchmarks/Messaging/NotificationFanOutBenchmarks.cs` - - 类级摘要明确当前 `GFramework.CQRS` fan-out 对照包含默认顺序发布器与内置 `TaskWhenAllNotificationPublisher` - - `GFramework.Cqrs.Benchmarks/Messaging/RequestBenchmarks.cs` - - `GFramework.Cqrs.Benchmarks/Messaging/StreamingBenchmarks.cs` - - 将 `Mediator` reader-facing 注释统一为 “NuGet `Mediator` 的 source-generated concrete mediator” - - `GFramework.Cqrs.Tests/Cqrs/CqrsDispatcherContextValidationTests.cs` - - 补一条 stream 缺失 handler 的失败语义回归,固定当前分支在调用点同步抛 `InvalidOperationException` - - worker 在 `CqrsGeneratedRequestInvokerProviderTests.cs` 补 request/generated + pipeline 对称测试后,主线程确认这不是环境噪音,而是命中了真实运行时缺口: - - request 路径在接入 `IPipelineBehavior<,>` 后,会退回 `_handler.Handle(...)` - - 因此 generated request invoker 无法像 stream 路径那样在 pipeline 末端继续保持优先 - - 主线程已在 `GFramework.Cqrs/Internal/CqrsDispatcher.cs` 收口该缺口: - - request pipeline executor 现在显式复用当前 binding 缓存的 `RequestInvoker` - - generated request invoker provider 在接入 pipeline 后保持与无 pipeline 路径一致的调用语义 - - 当前 stop decision: - - 不再继续下一波 - - 原因不是 `50 files` 阈值耗尽;当前 accepted scope 仍然很小 - - 停止原因是当前上下文已接近本轮安全预算,而剩余候选只剩 descriptor / factory / publisher 类小测试,继续扩批收益明显下降 + - 本轮先按 `$gframework-pr-review` 重新抓取当前分支 PR 真值,确认当前在审 PR 已从旧的 `PR #350(MERGED)` 切换为 + `PR #351(OPEN)`。 + - 当前 PR 没有 failed checks;GitHub Test Reporter 显示 `2379 passed / 0 failed`,当前 CI 没有测试阻塞信号。 + - 最新 head review 只有 `coderabbitai[bot]` 的 `4` 条 open threads,且都落在 + `ai-plan/public/cqrs-rewrite/todos/` 与 `ai-plan/public/cqrs-rewrite/traces/` 两份恢复文件上。 + - 这些线程指向的都是有效治理问题,而不是运行时代码缺陷: + - active tracking 仍停留在 `PR #350`,与当前 `PR #351` 不一致 + - active tracking 同时保留了“7 个源码/测试文件写面”与“branch diff 只剩两份 `ai-plan` 文档”两套互相冲突的事实 + - active trace 重新膨胀为追加式长日志,且包含 Markdown 结构噪音 + - 当前收口策略是把 `cqrs-rewrite` active tracking / trace 刷回“最小可恢复入口”,并把旧阶段流水继续留在 + `archive/`,避免在 `boot` 与后续 PR review 中继续暴露失真的恢复入口。 ## 当前活跃事实 - 当前分支:`feat/cqrs-optimization` -- 当前 HEAD / 基线:`origin/main @ 4837aa2a (2026-05-12 20:37:56 +0800)` -- 当前 PR:`PR #350(已合并到 origin/main)` -- 当前写面: - - `GFramework.Cqrs.Benchmarks/Messaging/NotificationFanOutBenchmarks.cs` - - `GFramework.Cqrs.Benchmarks/Messaging/RequestBenchmarks.cs` - - `GFramework.Cqrs.Benchmarks/Messaging/RequestLifetimeBenchmarks.cs` - - `GFramework.Cqrs.Benchmarks/Messaging/StreamingBenchmarks.cs` - - `GFramework.Cqrs.Tests/Cqrs/CqrsDispatcherContextValidationTests.cs` - - `GFramework.Cqrs.Tests/Cqrs/CqrsGeneratedRequestInvokerProviderTests.cs` - - `GFramework.Cqrs/Internal/CqrsDispatcher.cs` +- 当前 HEAD:`e5b173c29abb4ad2faf211bf8f20fd2075c1945c` +- 当前基线:`origin/main @ 4837aa2a (2026-05-12 20:37:56 +0800)` +- 当前 PR:`PR #351(OPEN)` +- 当前 review 焦点: - `ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md` - `ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md` -- 当前基线: - - `origin/main @ 4837aa2a (2026-05-12 20:37:56 +0800)` -- 当前 batch working-tree diff:`7` 个源码 / 测试文件 -- 当前工作面已收口为 docs/test 小切片 + 1 处 request pipeline runtime 修正;没有重新打开 benchmark 工程设计级改造 -- 最近已合并提交: - - `2dd9435c` `fix(cqrs-benchmarks): 修正Mediator基准运行时配置` - - `e3532fc2` `feat(cqrs-benchmarks): 补齐request生命周期的Mediator对照` - - `092946e9` `docs(cqrs-benchmarks): 同步startup基准文档边界` +- 当前工作面: + - 只收口 `cqrs-rewrite` 的 public recovery 文档,不重新打开 CQRS benchmark、runtime 或测试工程写面。 +- 当前 AI review 真值: + - CodeRabbit latest review:`CHANGES_REQUESTED`(`2026-05-14T02:21:55Z`) + - open threads:`4` + - 已本地复核为有效的主题: + - PR 锚点过期 + - active tracking 事实冲突 + - active trace 结构噪音 + - active trace 体积过大,应继续瘦身 ## 当前风险 -- 后续若再次评估 `StreamLifetimeBenchmarks` 或 request lifetime 的 `Mediator` parity,仍必须采用独立 compile-time config - 或独立 benchmark 工程,而不是在同一份 source-generated 产物上切换 runtime `ServiceLifetime`。 -- 如果 `feat/cqrs-optimization` 继续承载新的 CQRS 任务而不先分支,public recovery 入口会把“已合并的 PR #350”与下一轮新工作混在一起。 -- 若未来再开 benchmark XML / docs 波次,仍需要主线程先抽样核对代表文件,避免重复接受误报 inventory。 -- 剩余低风险候选主要是 `NotificationPublisher` / invoker descriptor / `CqrsRuntimeFactory` 的单文件测试;它们不是当前上下文预算下的高收益下一波。 +- 若继续沿用 `PR #350` 的恢复入口,后续 `boot` 与 PR triage 会把“已合并阶段”误当作当前审查上下文。 +- 若 active tracking 同时保留历史阶段事实与当前恢复事实,后续恢复会继续遭遇“当前写面”与“当前 branch diff”互相冲突的问题。 +- 若 active trace 再次回到追加式长日志,后续每一轮 PR review 都会优先命中文档治理噪音,而不是当前真正需要验证的 CQRS 代码问题。 ## 最近权威验证 -- `git rev-list --left-right --count origin/main...HEAD` +- `python3 .agents/skills/gframework-pr-review/scripts/fetch_current_pr_review.py --json-output /tmp/current-pr-review.json` - 结果:通过 - - 备注:在恢复刷新提交前返回 `0 0`,确认 `PR #350` 已完整合入 `origin/main` -- `git diff --name-only origin/main...HEAD | wc -l` + - 备注:确认当前分支对应 `PR #351`,并抓到 `4` 条 CodeRabbit open threads、`0` failed checks +- `python3 scripts/license-header.py --check --paths ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md` - 结果:通过 - - 备注:确认当前 branch diff 始终只覆盖两份 `ai-plan` recovery 文档,没有重新打开 CQRS benchmark 代码写面 -- `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` - - 结果:通过,`0 warning / 0 error` - - 备注:确认 benchmark reader-facing 文档收口后工程仍保持 `Release` 可编译 + - 备注:本轮改动的 public recovery 文档均保留 Apache-2.0 头 +- `git diff --check` + - 结果:通过 + - 备注:本轮 `ai-plan` 收口未引入 patch 格式或 trailing whitespace 问题 - `dotnet build GFramework.Cqrs/GFramework.Cqrs.csproj -c Release` - 结果:通过,`0 warning / 0 error` - - 备注:确认 request pipeline 复用 generated invoker 的 runtime 修正未引入编译回归 -- `dotnet test GFramework.Cqrs.Tests/GFramework.Cqrs.Tests.csproj -c Release --filter "FullyQualifiedName~CqrsGeneratedRequestInvokerProviderTests"` - - 结果:通过,`Passed: 28, Failed: 0` - - 备注:确认 generated request invoker 在接入 request pipeline 后仍保持优先,并通过新增回归测试锁定 -- `dotnet test GFramework.Cqrs.Tests/GFramework.Cqrs.Tests.csproj -c Release --filter "FullyQualifiedName~CqrsDispatcherContextValidationTests"` - - 结果:通过,`Passed: 7, Failed: 0` - - 备注:确认 stream 缺失 handler 的失败语义回归与既有上下文校验测试仍全部通过 + - 备注:满足仓库“完成任务前至少通过一条 build validation”的要求 +- GitHub Test Reporter(来自 `PR #351` 的最新 review 数据) + - 结果:通过 + - 备注:`2379 passed / 0 failed / 38.4s` +- MegaLinter(来自 `PR #351` 的最新 review 数据) + - 结果:`Success with warnings` + - 备注:当前高信号问题仍是 `ai-plan` 文档治理收口;未观察到新的 CQRS 运行时代码失败信号 ## 下一推荐步骤 -1. 若继续 CQRS 主题的低风险硬化,优先从 `NotificationPublisher`、invoker descriptor、`CqrsRuntimeFactory` 三类单文件测试候选中再挑一条,不要重新打开 benchmark 设计级议题。 -2. 若后续重新打开 `Mediator` 生命周期 parity 工作,优先设计独立 compile-time config / 独立 benchmark 工程,并把该设计单独记录到新的 tracking phase。 -3. 若只是恢复其他 topic,可把当前 `cqrs-rewrite` active 入口视为“本轮已在上下文预算前的自然停点完成”。 +1. 先完成 `ai-plan/public/cqrs-rewrite/**` 的 active 入口瘦身与事实刷新,再重新运行最小验证。 +2. 若文档收口后 PR 仍有 open threads,再次执行 `$gframework-pr-review`,确认是否只剩 stale review 线程。 +3. 只有在文档治理线程清空后,才继续评估是否存在新的 CQRS benchmark / runtime / test 跟进项。 ## 活跃文档 @@ -108,5 +91,6 @@ CQRS 迁移与收敛。 ## 说明 -- `RP-131` 及之前的长历史验证、阶段流水与旧恢复点说明已迁移到新的 `archive/` 文件,不再继续堆叠在 active 入口。 -- active tracking 现在只保留当前恢复点所需的最小事实、风险、权威验证与下一步,供 `boot` 与后续 PR review 快速恢复。 +- `RP-131` 及更早长历史已保留在 `archive/`,active 入口不再重复堆叠旧阶段流水。 +- `RP-142` 与 `RP-143` 的细节已压缩为当前恢复点结论与 active trace 摘要,避免继续把 active 入口用作追加式日志。 +- 本地再次执行 `$gframework-pr-review` 时,GitHub 仍返回旧 head 上的 `4` 条 open threads;在本轮 `ai-plan` 修复提交推到新 head 前,这些线程仍会继续显示为未解决。 diff --git a/ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md b/ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md index 83756595..52328f5f 100644 --- a/ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md +++ b/ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md @@ -5,34 +5,67 @@ SPDX-License-Identifier: Apache-2.0 # CQRS 重写迁移追踪 +## 当前恢复摘要 + +- 当前恢复点:`CQRS-REWRITE-RP-144` +- 当前日期:`2026-05-14` +- 当前分支:`feat/cqrs-optimization` +- 当前 PR:`PR #351(OPEN)` +- 当前目标: + - 用 `$gframework-pr-review` 重新对齐当前 PR 真值 + - 修复 `cqrs-rewrite` active tracking / trace 的过期与膨胀问题 + - 让 `boot` 与后续 PR triage 回到最小可恢复入口 +- 历史归档入口: + - `RP-131` 及之前:`ai-plan/public/cqrs-rewrite/archive/traces/cqrs-rewrite-migration-trace-history-through-rp131.md` + - `RP-131` 及之前对应 tracking:`ai-plan/public/cqrs-rewrite/archive/todos/cqrs-rewrite-migration-tracking-history-through-rp131.md` + +## 2026-05-14 + +### 阶段:PR #351 的 active recovery 入口收口(CQRS-REWRITE-RP-144) + +- 先执行 `$gframework-pr-review` 抓取当前分支的 GitHub 真值,而不是沿用 active tracking 里过期的 `PR #350` 状态。 +- 当前抓取结果: + - 当前 PR:`#351` + - 状态:`OPEN` + - 最新 reviewed commit:`e5b173c29abb4ad2faf211bf8f20fd2075c1945c` + - failed checks:`0` + - 测试汇总:`2379 passed / 0 failed` + - latest-head open threads:`4` +- 4 条 open threads 的本地复核结论: + - `todos/cqrs-rewrite-migration-tracking.md` + - `PR #350(MERGED)` 已不再代表当前审查上下文,必须刷新为 `PR #351(OPEN)` + - “当前 batch working-tree diff:7 个源码 / 测试文件”与“branch diff 只覆盖两份 `ai-plan` 文档”互相冲突,不能继续同时保留 + - `traces/cqrs-rewrite-migration-trace.md` + - 出现重复日期标题与多余反引号,属于应当立即清掉的 Markdown 结构噪音 + - active trace 已重新膨胀成追加式长日志,不适合继续作为默认恢复入口 +- 当前收口动作: + - 重写 active tracking,使其只保留 `PR #351` 的当前恢复真值、风险、验证与下一步 + - 重写 active trace,使其只保留 `RP-144` 摘要与必要的最近阶段记录 + - 继续把更早阶段细节留在 `archive/`,避免再次扩大 active 入口 +- 本轮本地验证: + - `python3 scripts/license-header.py --check --paths ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md` + - 结果:通过 + - `git diff --check` + - 结果:通过 + - `dotnet build GFramework.Cqrs/GFramework.Cqrs.csproj -c Release` + - 结果:通过,`0 warning / 0 error` + - 再次执行 `$gframework-pr-review` + - 结果:仍显示旧 head 上的 `4` 条 CodeRabbit open threads + - 说明:这些线程要等本轮 `ai-plan` 修复提交形成新的 PR head 后,才有机会被 GitHub 标记为 stale 或 resolved +- 当前下一步: + - 提交本轮 `ai-plan` recovery 入口收口 + - 推送后重新执行 `$gframework-pr-review`,确认当前 open threads 是否随新 head 收敛 + ## 2026-05-13 -### 阶段:允许 subagent 后的低风险多 Agent 收口(CQRS-REWRITE-RP-143) +### 阶段:request pipeline generated invoker 收口(CQRS-REWRITE-RP-143) -- 在用户允许 subagent 后,主线程切到小型 multi-agent 协调模式,但仍把 critical path 保留在本地: - - 主线程负责候选筛选、runtime 缺口判断、最终验证与 `ai-plan` - - explorer 只做只读盘点 - - worker 只接单文件或窄文件组 ownership -- explorer 结论汇总: - - 没有值得继续扩成“实现型 benchmark 波次”的大切片 - - 低风险候选主要是 reader-facing 术语对齐与单文件回归测试 - - `Mediator` 生命周期 parity、notification fan-out 生命周期矩阵、benchmark 工程级拆分仍判定为高风险 -- accepted worker / 主线程 scope: - - `RequestLifetimeBenchmarks.cs` - - 主线程修正 2 处 XML 文档缩进异常 - - `NotificationFanOutBenchmarks.cs` - - `RequestBenchmarks.cs` - - `StreamingBenchmarks.cs` - - worker 收口 benchmark reader-facing 术语,build 通过 - - `CqrsDispatcherContextValidationTests.cs` - - worker 补 stream 缺失 handler 的同步抛错回归,targeted test 通过 - - `CqrsGeneratedRequestInvokerProviderTests.cs` - - worker 补 generated request + pipeline 对称测试 - - 首次运行失败,暴露 request pipeline 路径在接入 behavior 后退回 `_handler.Handle(...)` - - `CqrsDispatcher.cs` - - 主线程将 request pipeline 末端改为继续复用当前 binding 的 `RequestInvoker` - - 使 generated request invoker provider 在 pipeline 存在时保持与无 pipeline 路径一致 -- 本轮权威验证: +- 在用户允许 subagent 后,本轮只接受 docs/test 小切片与 1 处 request pipeline runtime 修正,未重新打开 benchmark 工程设计级改造。 +- 本轮关键结论: + - `CqrsGeneratedRequestInvokerProviderTests.cs` 的新增对称测试证明 request 路径在接入 `IPipelineBehavior<,>` 后,会退回 `_handler.Handle(...)` + - `GFramework.Cqrs/Internal/CqrsDispatcher.cs` 已把 request pipeline 末端改为继续复用当前 binding 的 `RequestInvoker` + - generated request invoker provider 在 pipeline 存在时恢复与无 pipeline 路径一致的调用语义 +- 当轮验证: - `dotnet build GFramework.Cqrs/GFramework.Cqrs.csproj -c Release` - 结果:通过,`0 warning / 0 error` - `dotnet test GFramework.Cqrs.Tests/GFramework.Cqrs.Tests.csproj -c Release --filter "FullyQualifiedName~CqrsGeneratedRequestInvokerProviderTests"` @@ -41,440 +74,5 @@ SPDX-License-Identifier: Apache-2.0 - 结果:通过,`Passed: 7, Failed: 0` - `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` - 结果:通过,`0 warning / 0 error` -- 当前 stop decision: - - 不再继续下一波 - - 原因不是 branch-size;当前变更仍远低于 `$gframework-batch-boot 50`` - - 停止原因是主线程上下文已接近本轮安全预算,而剩余候选只剩收益较低的单文件测试硬化 -- 当前下一步: - - 更新 `ai-plan/public/cqrs-rewrite/**` - - 运行 license-header / `git diff --check` - - 提交本轮多 Agent 小波次收口 - -## 2026-05-13 - -### 阶段:PR #350 合并后的 recovery 入口刷新(CQRS-REWRITE-RP-142) - -- 继续按 `$gframework-batch-boot 50` 恢复当前 topic,但启动时先核对分支真值,而不是沿用 active tracking 中的旧 PR 状态。 -- 本轮基线按 skill 规则固定为 `origin/main @ 4837aa2a (2026-05-12 20:37:56 +0800)`。 -- 本地核对结果: - - `feat/cqrs-optimization` 当前 `HEAD` 与 `origin/main` 指向同一合并提交 `4837aa2a` - - `git rev-list --left-right --count origin/main...HEAD` 返回 `0 0` - - `git diff --name-only origin/main...HEAD | wc -l` 返回 `0` - - 当前工作树干净,不存在可继续扩批的 CQRS benchmark / test 写面 -- 批处理候选重判: - - 不再把当前任务视为新的 benchmark 批处理波次 - - 原因不是 `50 files` 阈值耗尽,而是语义边界已经完成,继续在已合并 topic 上扩批只会制造恢复入口噪音 -- 本轮 accepted scope: - - `ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md` - - `ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md` -- 本轮主线程收口目标: - - 把 active tracking 从 `PR #350(OPEN)` 刷新为 `PR #350(MERGED)` - - 把 branch metric 从过期的 `14 files` 刷新为 `0 files / 0 lines` - - 把“继续回 GitHub resolve thread”替换为“下一轮 CQRS 工作应从新分支 / 新 recovery point 开始” -- recovery 刷新提交落地后,当前 branch diff 仍只覆盖 `cqrs-rewrite` 的 public tracking / trace 文档,没有重新打开 benchmark 代码写面 -- 当前下一步: - - 若后续继续 CQRS 主题,实现工作应从新的 topic branch 与新的 recovery point 开始 - - 若只是恢复其他 topic,可把当前 `cqrs-rewrite` active 入口视为已停在自然边界 - -## 2026-05-12 - -### 阶段:PR #350 的 Mediator runtime 配置收口(CQRS-REWRITE-RP-141) - -- 使用 `$gframework-pr-review` 重新抓取当前分支 PR,确认 GitHub 真值已从 active tracking 中过期的 `PR #349` 切换为仍处于 `OPEN` 状态的 `PR #350`。 -- 最新 AI review 只剩 1 条 Greptile open thread: - - `GFramework.Cqrs.Benchmarks/Messaging/StreamStartupBenchmarks.cs:210` - - 质疑点不是文档,而是 `Mediator` startup / request lifetime 新路径仅编译通过、未实际 smoke-run -- 主线程先按 review 建议做本地 smoke 验证,而不是直接回复线程: - - `dotnet run --project GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release --no-build -- --artifacts-suffix pr350-stream-startup-mediator --filter "*StreamStartupBenchmarks.ColdStart_Mediator*" --job short --warmupCount 1 --iterationCount 1 --launchCount 1` - - `dotnet run --project GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release --no-build -- --artifacts-suffix pr350-request-lifetime-mediator --filter "*RequestLifetimeBenchmarks.SendRequest_Mediator*" --job short --warmupCount 1 --iterationCount 1 --launchCount 1` -- 第一轮 smoke 暴露出 Greptile 线程背后的真实运行时问题,而不是 review 噪音: - - `StreamStartupBenchmarks.ColdStart_Mediator()` 在 BenchmarkDotNet 自动生成宿主里抛出 - `Invalid configuration detected for Mediator. Generated code for 'Transient' lifetime, but got 'Singleton' lifetime from options.` - - `RequestLifetimeBenchmarks.SendRequest_Mediator()` 的 `Singleton` / `Scoped` 同样抛出相同异常,只有 `Transient` 分支能实际执行 -- 根因判断: - - `Mediator` 的 DI lifetime 由 source generator 在 benchmark 项目编译期固定 - - 当前项目同时包含默认 `AddMediator()` 和 request lifetime 场景里的 `AddMediator(options => options.ServiceLifetime = ...)` - - 同一份生成产物在 BenchmarkDotNet 自动生成宿主里因此出现 compile-time lifetime 与 runtime options 不一致 -- 主线程修复: - - `BenchmarkHostFactory.CreateMediatorServiceProvider()` 统一改为显式 `ServiceLifetime.Singleton` - - `RequestLifetimeBenchmarks` 删除当前无法真实运行的 `SendRequest_Mediator()` 与相关 `Mediator` 生命周期 helper / 契约实现 - - `GFramework.Cqrs.Benchmarks/README.md` 将 request lifetime coverage 收窄为 `GFramework.Cqrs` + `MediatR`,并把 `Mediator` lifetime parity 改记为当前缺口 -- 串行验证结果: - - `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` - - 结果:通过,`0 warning / 0 error` - - `dotnet run --project GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release --no-build -- --artifacts-suffix pr350-stream-startup-mediator-fixed --filter "*StreamStartupBenchmarks.ColdStart_Mediator*" --job short --warmupCount 1 --iterationCount 1 --launchCount 1` - - 结果:通过 - - 关键数值:`ColdStart_Mediator ≈ 144.036 us / 69.3 KB` - - `dotnet run --project GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release --no-build -- --artifacts-suffix pr350-request-lifetime-fixed-rerun --filter "*RequestLifetimeBenchmarks*" --job short --warmupCount 1 --iterationCount 1 --launchCount 1` - - 结果:通过 - - 关键结论:当前 request lifetime 矩阵已收敛为 `9` 项(baseline / `GFramework.Cqrs` / `MediatR` * `Singleton|Scoped|Transient`),不再包含伪 `Mediator` lifetime 条目 -- 本轮 stop decision: - - 不继续把 `Mediator` lifetime parity 硬扩到 request 或 stream lifetime benchmark - - 原因不是 branch-size;而是 source-generator compile-time config 已明确构成真实边界,继续在同一项目里扩 runtime 切换只会制造新的伪覆盖 - -### 阶段:request lifetime 的 Mediator parity 与文档漂移收口(CQRS-REWRITE-RP-140) - -- 继续按 `$gframework-batch-boot 50` 推进,基线保持为 `origin/main @ 2b2bec65 (2026-05-12 11:49:39 +0800)`。 -- 本轮启动时重新测得当前已提交 branch diff 仍为 `14 files / 324 lines`,远低于 `50 files` 阈值;停止与否继续由 context-budget / reviewability 主导。 -- 主线程结合两个 explorer 子代理的只读盘点后,接受以下结论: - - 不再继续按 benchmark XML `` inventory 机械扩批;粗糙脚本会把“注释位于 `[Benchmark]` 之前”的现有文档误判为缺口 - - `RequestLifetimeBenchmarks` 的 NuGet `Mediator` lifetime parity 是当前仍然真实、且能保持 reviewable 的实现候选 - - `NotificationBenchmarks.cs` 与 `RequestBenchmarks.cs` 仍有两处低风险 XML 文档漂移,均只涉及 NuGet `Mediator` 事实同步 -- 本轮主线程实施: - - `RequestLifetimeBenchmarks.cs` - - 新增 `GeneratedMediator` 宿主字段、`SendRequest_Mediator()` benchmark 方法与 scoped `Mediator` request helper - - 将 `BenchmarkRequest` / `BenchmarkRequestHandler` 扩为同时实现 `Mediator` 契约 - - 为 `Mediator` 宿主改用 `Singleton / Scoped / Transient` 三个编译期常量分支,规避 `MSG0007` 对运行时 lifetime 赋值的生成器限制 - - `RequestBenchmarks.cs` - - 将 handler XML 文档说明补齐为同时实现 `GFramework.CQRS`、NuGet `Mediator` 与 `MediatR` - - `NotificationBenchmarks.cs` - - 将类说明与 handler XML 文档说明补齐为同时覆盖 `GFramework.CQRS`、NuGet `Mediator` 与 `MediatR` - - `GFramework.Cqrs.Benchmarks/README.md` - - 将 `RequestLifetimeBenchmarks` 的 coverage 更新为包含 NuGet `Mediator` source-generated concrete path - - 删除“当前没有 request 生命周期下的 NuGet `Mediator` compile-time lifetime 矩阵”这一已过时缺口 -- 验证里程碑: - - 第一次 `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` - - 结果:失败 - - 原因:`RequestLifetimeBenchmarks.cs` 中基于运行时变量写入 `MediatorOptions.ServiceLifetime`,触发 `MSG0007` - - 主线程修正: - - 将 `CreateMediatorServiceProvider(HandlerLifetime lifetime)` 收口为 3 个常量分支工厂: - `CreateSingletonMediatorServiceProvider()`、`CreateScopedMediatorServiceProvider()`、`CreateTransientMediatorServiceProvider()` - - 第二次 `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` - - 结果:通过,`0 warning / 0 error` -- 当前 stop decision: - - 不继续开启新的实现波次 - - 原因不是 branch-size 阈值耗尽;当前分支仍只有 `14 files` - - 停止原因是本轮已经完成一条真实 parity 收口和两处文档漂移修正,继续扩到 `StreamLifetimeBenchmarks` 会显著提高作用域与 review 成本 -- 当前下一步: - - 主线程补跑 `python3 scripts/license-header.py --check --paths ...` 与 `git diff --check` - - 更新 active tracking / trace 后提交当前 benchmark 代码、README 与 `ai-plan` - -### 阶段:README startup coverage 精度同步并停在自然边界(CQRS-REWRITE-RP-139) - -- 继续按 `$gframework-batch-boot 50` 推进,基线保持为 `origin/main @ 2b2bec65 (2026-05-12 11:49:39 +0800)`。 -- 本轮启动时重新测得当前已提交 branch diff 为 `14 files`,仍远低于 `50 files` 阈值;继续与否的主停止信号仍是 - context-budget / reviewability。 -- 本轮主线程先做只读盘点与抽样核对: - - README 一致性 explorer 结论成立:`GFramework.Cqrs.Benchmarks/README.md` 对 startup coverage / 边界的表述仍可更精确 - - benchmark XML 缺口 explorer 结论未直接接受;主线程抽样检查 `NotificationBenchmarks.cs`、 - `RequestBenchmarks.cs`、`StreamingBenchmarks.cs`、`NotificationStartupBenchmarks.cs` 后确认, - 其 class / benchmark 方法的 `` 与 `` 实际已存在,不能继续按“14 个门面文件普遍缺 XML” - 的假设扩批 -- 因此本轮 accepted delegated scope 缩成单文件 docs-only worker: - - `GFramework.Cqrs.Benchmarks/README.md` - - 把 `StreamStartupBenchmarks` 明确写成 `MediatR`、`GFramework.Cqrs` reflection、 - `GFramework.Cqrs` generated、NuGet `Mediator` 四组 initialization / cold-start 对照 - - 补充 `RequestStartupBenchmarks` 与 `NotificationStartupBenchmarks` 的 `GFramework.Cqrs` startup 路径是 - “单 handler 最小宿主 + 手工注册”模型,不外推到程序集扫描、完整注册协调器、fan-out 或发布策略变体 -- worker 回传验收结论: - - 改动文件未越出 ownership 边界 - - README diff 与代码事实一致,且未引入无法从当前 benchmark 实现验证的表述 -- 当前 stop decision: - - 不继续开启新的 XML 文档波次 - - 原因不是 branch-size 阈值耗尽;当前分支仍只有 `14 files` - - 停止原因是候选清晰度下降:继续追逐 explorer 误报会降低 reviewability,并无谓增加当前上下文负担 -- 当前下一步: - - 主线程更新 `ai-plan/public/cqrs-rewrite/**` - - 串行运行 benchmark 工程 build、license-header 与 `git diff --check` - - 提交 README 与 `ai-plan` 收尾 - -### 阶段:benchmark XML 契约第 2 波收口(CQRS-REWRITE-RP-138) - -- 延续 `$gframework-batch-boot 50`,基线保持为 `origin/main @ 2b2bec65 (2026-05-12 11:49:39 +0800)`。 -- 第 2 波启动前,当前分支相对基线的已提交 branch diff 为 `5 files / 177 lines`,明显低于 `50 files` 阈值;本轮继续与否的主停止信号仍是 context-budget / reviewability。 -- 主线程本地盘点 `GFramework.Cqrs.Benchmarks/Messaging/*.cs` 的公开 `[Benchmark]` 方法后,确认当前仍有一批与既有收口模式一致的 XML `` 缺口: - - `StreamingBenchmarks.Stream_GFrameworkCqrs()` - - `NotificationBenchmarks` 的 3 个公开 benchmark 方法 - - `NotificationFanOutBenchmarks` 的 5 个公开 benchmark 方法 - - `StreamInvokerBenchmarks` 的 4 个公开 benchmark 方法 - - `StreamLifetimeBenchmarks` 的 4 个公开 benchmark 方法 -- 本波 accepted ownership: - - 主线程 - - `GFramework.Cqrs.Benchmarks/Messaging/StreamingBenchmarks.cs` - - `GFramework.Cqrs.Benchmarks/Messaging/NotificationBenchmarks.cs` - - `ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md` - - `ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md` - - worker - - `StreamLifetimeBenchmarks.cs` - - `StreamInvokerBenchmarks.cs` - - `NotificationFanOutBenchmarks.cs` -- worker 回传验收结论: - - `StreamLifetimeBenchmarks.cs` - - 只补 `Stream_Baseline`、`Stream_GFrameworkReflection`、`Stream_GFrameworkGenerated`、`Stream_MediatR` 的 `` - - worker 自报 `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` 通过 - - `StreamInvokerBenchmarks.cs` - - 只补 4 个公开 benchmark 方法的 `` - - worker 自报同一条 benchmark 工程 build 通过 - - `NotificationFanOutBenchmarks.cs` - - 只补 5 个公开 benchmark 方法的 `` - - worker 自报 build 遇到 `CS2012`:`obj/Release/net10.0/GFramework.Cqrs.Benchmarks.dll` 被并发进程占用;该失败被判定为并发构建噪音,而不是代码语义问题 -- 主线程局部实施: - - `StreamingBenchmarks.cs` - - 为 `Stream_GFrameworkCqrs()` 补 `` - - `NotificationBenchmarks.cs` - - 为 `PublishNotification_GFrameworkCqrs()`、`PublishNotification_MediatR()`、`PublishNotification_Mediator()` 补 `` -- 当前下一步: - - 主线程串行执行 benchmark 工程 Release build,消除 worker 并发写 `obj/Release` 带来的验证噪音 - - 若串行验证通过,决定是在当前自然停点提交收尾,还是继续 request 侧 XML 契约的下一波低风险批处理 - -### 阶段:request benchmark XML 契约第 3 波收口后停在自然边界(CQRS-REWRITE-RP-138) - -- 第 2 波串行验证通过后,继续用 3 个 worker 扩展 request 系 benchmark 的同类 `` 收口: - - `RequestStartupBenchmarks.cs` - - `RequestBenchmarks.cs` + `RequestPipelineBenchmarks.cs` - - `RequestInvokerBenchmarks.cs` + `RequestLifetimeBenchmarks.cs` -- worker 回传与 acceptance: - - `RequestStartupBenchmarks.cs` - - 只补公开 benchmark 方法缺失的 `` - - worker 自报 `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` 通过 - - `RequestBenchmarks.cs` + `RequestPipelineBenchmarks.cs` - - 只补公开 benchmark 方法缺失的 `` - - worker 自报 build 通过,并已提交:`555c7c07 docs(cqrs-benchmarks): 补齐 request benchmark 返回值文档` - - `RequestInvokerBenchmarks.cs` + `RequestLifetimeBenchmarks.cs` - - 只补公开 benchmark 方法缺失的 `` - - worker 自报 build 通过,并已提交:`ab422b05 docs(cqrs-benchmarks): 补齐 request benchmark 返回值注释` -- 第 3 波后主线程 stop decision: - - 不再开启第 4 波 XML 契约批处理 - - 原因不是 branch-size 阈值耗尽;当前分支相对 `origin/main` 仍只有 `9 files / 143 lines` - - 停止原因是 context-budget / reviewability:剩余候选已不比当前波次更低风险,继续机械扩批收益下降 -- 当前下一步: - - 只做主线程未提交面的串行验证与收尾提交 - - 将干净工作树作为下一次 `boot` 的默认恢复目标 - -### 阶段:stream startup parity 与文档收尾(CQRS-REWRITE-RP-137) - -- 按 `$gframework-batch-boot 50` 恢复后,先重新执行 `$gframework-pr-review`。 -- 当前 GitHub 事实: - - `PR #349` 已关闭并合并到 `origin/main` - - 基线切换为 `origin/main @ 2b2bec65 (2026-05-12 11:49:39 +0800)` - - 当前分支相对新基线的已提交 diff 初始为 `0 files / 0 lines` -- latest-head open thread 本地复核: - - stale - - `StreamPipelineBenchmarks.Stream_Baseline` 的 `` 已存在 - - `CqrsNotificationPublisherTests` 的 fallback 缓存安全网已收口 - - trace 的当前 PR / 下一步已同步到 `PR #349` - - valid - - `StreamingBenchmarks.Stream_MediatR()` 仍缺 `` XML 文档 -- 第 1 波 accepted delegated scope: - - `StreamingBenchmarks.cs` - - worker 补 `Stream_Baseline()` 与 `Stream_MediatR()` 的 `` XML 契约 - - 主线程验收时确认其中 `Stream_Baseline()` 属于额外收口,不是 latest-head 必修项 - - `StreamStartupBenchmarks.cs` - - worker 在单文件 ownership 内补 `GeneratedMediator` 宿主字段、setup/cleanup、`Initialization_Mediator()`、`ColdStart_Mediator()` - - 同文件把 `BenchmarkStreamRequest` / `BenchmarkStreamHandler` 扩成同时支持 `Mediator` stream 合同 - - worker 自主完成并提交:`f346110a feat(cqrs-benchmarks): 补齐 stream startup 的 Mediator 对照路径` - - `GFramework.Cqrs.Benchmarks/README.md` - - worker 只收口 `StreamStartupBenchmarks` coverage 与当前 gap 描述,不假设 `StreamLifetimeBenchmarks` 已补 parity -- 主线程验收结论: - - `StreamLifetimeBenchmarks` 的 `Mediator` parity 被判定为 hard slice,需要 `BenchmarkHostFactory` 与 compile-time lifetime 配套,不再继续作为本 turn 的低风险并行切片 - - 当前自然停点应落在: - - 已提交的 `StreamStartupBenchmarks` parity - - 未提交但已验收的 `StreamingBenchmarks.cs` / `README.md` 收尾 - - `ai-plan` 同步到新基线与新恢复点 -- 本轮权威验证里程碑: - - `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` - - 结果:通过,`0 warning / 0 error` - - `python3 scripts/license-header.py --check` - - 结果:通过 - - `git diff --check` - - 待当前未提交收尾切片与 `ai-plan` 一并提交前再次运行 -- 当前下一步: - - 提交 `StreamingBenchmarks.cs`、`GFramework.Cqrs.Benchmarks/README.md` 与 `ai-plan/public/cqrs-rewrite/**` 收尾 - - 如需继续 benchmark 波次,优先做 `StreamStartupBenchmarks` 的最小 smoke run,而不是直接展开 `StreamLifetimeBenchmarks` - -### 阶段:PR #349 latest-head review 收口(CQRS-REWRITE-RP-136) - -- 重新执行 `$gframework-pr-review`,按 GitHub 当前分支状态确认 `feat/cqrs-optimization` 在 `2026-05-12` 对应的是 `PR #349`,不再沿用 active tracking 中的 `PR #348` 锚点。 -- 本轮 latest-head open AI thread 复核结论: - - `StreamPipelineBenchmarks` 的 `Stream_Baseline`、`Stream_GFrameworkCqrs`、`Stream_MediatR` 缺少 `` XML 契约,接受修复 - - `StreamingBenchmarks.Stream_Mediator` 缺少 `` XML 契约,接受修复 - - `CqrsNotificationPublisherTests` 的 fallback publisher 缓存回归测试用“第二次解析返回另一个 publisher”充当安全网,和断言消息表达不一致,接受收口为“首次后任何再次解析都直接失败” - - active tracking / trace 的当前 PR 锚点与下一步入口仍停留在 `PR #348`,接受同步到 `PR #349` -- 本轮主线程实施: - - `StreamPipelineBenchmarks` - - 为 3 个公开 benchmark 方法补齐 `` XML 文档 - - `StreamingBenchmarks` - - 为 `Stream_Mediator()` 补齐 `` XML 文档 - - `CqrsNotificationPublisherTests` - - 把 fallback publisher 缓存回归测试改为“首次返回空数组,后续任何再次解析立即抛 `AssertionException`”,避免测试安全网与失败消息自相矛盾 - - `ai-plan/public/cqrs-rewrite/**` - - 将 active tracking / trace 的当前 PR 锚点与下一步入口同步到 `PR #349` -- 本轮权威验证: - - `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` - - 结果:通过,`0 warning / 0 error` - - `dotnet test GFramework.Cqrs.Tests/GFramework.Cqrs.Tests.csproj -c Release --filter "FullyQualifiedName~CqrsNotificationPublisherTests"` - - 结果:通过,`Passed: 9, Failed: 0` - - `python3 scripts/license-header.py --check --paths GFramework.Cqrs.Benchmarks/Messaging/StreamPipelineBenchmarks.cs GFramework.Cqrs.Benchmarks/Messaging/StreamingBenchmarks.cs GFramework.Cqrs.Tests/Cqrs/CqrsNotificationPublisherTests.cs ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md` - - 结果:通过 - -### 阶段:多波 batch 继续收口(CQRS-REWRITE-RP-135) - -- 按 `$gframework-batch-boot 50` 恢复当前 topic,并把基线固定为 - `origin/main @ ef4d3d5d (2026-05-11 17:33:43 +0800)`。 -- 启动时确认当前工作树干净,branch diff 为 `0 files / 0 lines`;旧 tracking 中“未提交收尾切片”已不再反映真实仓库状态。 -- 第 1 波 accepted delegated scope: - - `CqrsRegistrationServiceTests` - - 补空输入不触发 registrar、忽略空项后按稳定程序集键排序并去重、跨调用跳过已注册键时继续处理剩余新程序集 - - `CqrsHandlerRegistrarTests` + `CqrsHandlerRegistrarFallbackFailureTests` - - 补 abstract registry 与缺少无参构造器 registry 在程序集级回退路径和 direct activation 入口的告警 / 抛错覆盖 - - `StreamPipelineBenchmarks` + `GFramework.Cqrs.Benchmarks/README.md` - - 新增 `0 / 1 / 4` 个 stream pipeline 行为与 `FirstItem / DrainAll` 观测矩阵 - - README 补齐 stream pipeline coverage、运行示例与 gap 说明 -- 第 2 波 accepted delegated scope: - - `CqrsNotificationPublisherTests` - - 补“容器未注册 publisher 时回退到 `SequentialNotificationPublisher`,且首次解析后缓存结果”回归 - - `StreamingBenchmarks` + `GFramework.Cqrs.Benchmarks/README.md` - - 补 steady-state stream 的 `Mediator` 对照 - - README 将 stream steady-state gap 收口为“lifetime / startup 仍缺 `Mediator` parity” -- 主线程验收与修正: - - 审核 5 个 worker 提交均未越出 ownership 边界 - - 在 `StreamPipelineBenchmarks.cs` 修掉 `git diff --check` 报出的 1 处 trailing whitespace - - 更新 active tracking / trace 到当前 branch 事实,避免下次 `boot` 继续落到过期恢复点 -- 本轮权威验证: - - `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` - - `dotnet test GFramework.Cqrs.Tests/GFramework.Cqrs.Tests.csproj -c Release --filter "FullyQualifiedName~CqrsRegistrationServiceTests|FullyQualifiedName~CqrsHandlerRegistrarTests|FullyQualifiedName~CqrsHandlerRegistrarFallbackFailureTests|FullyQualifiedName~CqrsNotificationPublisherTests"` - - `python3 scripts/license-header.py --check --paths ...` - - `git diff --check origin/main...HEAD` -- 当前停点判断: - - 当前 branch diff 约为 `9 files / 1111 lines` - - 明显低于 `50 files` 阈值 - - 本轮停止信号来自 `context-budget / reviewability`,不是文件预算耗尽 -- 当前下一步: - - 先按需要运行 `$gframework-pr-review`,确认 `PR #349` latest-head open thread 是否已随当前修复提交收敛 - - 若继续扩 benchmark,优先补 `StreamLifetimeBenchmarks` 或 `StreamStartupBenchmarks` 的单文件 `Mediator` parity - - 若切回文档收尾,把 `GFramework.Cqrs/README.md`、`docs/zh-CN/core/command.md`、`docs/zh-CN/core/query.md` 单独作为 docs-only 下一波 - -## 2026-05-11 - -### 阶段:PR #348 latest-head review 再收口(CQRS-REWRITE-RP-134) - -- 重新执行 `$gframework-pr-review` 抓取当前分支 `feat/cqrs-optimization` 对应的 `PR #348` -- 本轮 latest-head open AI thread 复核结论: - - `NotificationLifetimeBenchmarks.HandlerLifetime` 补 `[GenerateEnumExtensions]` 仍判定为泛化误报 - - 仓库没有“产品/benchmark 枚举默认都启用该特性”的现行约定 - - benchmark 项目也未接入 `GFramework.Core.SourceGenerators.Abstractions`,不应为局部对照枚举平白扩大 generator 依赖面 - - `NotificationLifetimeBenchmarks` 的 `_scopedContainer` 释放缺口与公开 benchmark API 的 XML 契约缺口仍成立,接受修复 - - `CqrsHandlerRegistrar` 中 generated descriptor 的“先去重后校验”缺陷仍成立,接受修复并补测试 - - `CqrsHandlerRegistrar` 对 `MethodInfo` 使用 `ReferenceEquals` 的过严比较仍成立,接受修复 - - active tracking / trace 的当前 PR 锚点仍停留在 `PR #347`,接受同步到 `PR #348` -- 本轮主线程实施: - - `NotificationLifetimeBenchmarks` - - `Cleanup()` 将 `_scopedContainer` 一并交给 `BenchmarkCleanupHelper.DisposeAll(...)` - - 为公开 benchmark 方法与公开 handler 方法补齐缺失的 `` / `` XML 契约 - - `CqrsHandlerRegistrar` - - request / stream generated descriptor 预热路径改为“先 `TryValidate...`,后写入 `registeredKeys`” - - descriptor 对齐判断从 `ReferenceEquals(resolvedDescriptor.InvokerMethod, ...)` 调整为 `resolvedDescriptor.InvokerMethod.Equals(...)` - - `CqrsGeneratedRequestInvokerProviderTests` - - 新增 request / stream 两个回归用例,锁定“首条同键 descriptor 无效、后条有效时,仍应接受后条有效 generated descriptor” - - `ai-plan/public/cqrs-rewrite/**` - - 将 active tracking / trace 的当前 PR 锚点同步到 `PR #348` - -### 阶段:PR #347 latest-head review 收口(CQRS-REWRITE-RP-132) - -- 使用 `$gframework-pr-review` 重新抓取当前分支 `feat/cqrs-optimization` 对应的 `PR #347` -- 抓取结果显示当前 latest-head 仍有 `CodeRabbit 6` 与 `Greptile 2` open thread,但本地复核后只接受以下仍成立的结论: - - `Program.cs` 只在命令行 `--artifacts-suffix` 下重启隔离宿主,未覆盖环境变量触发的隔离路径 - - `Program.cs` 缺少“目标隔离宿主目录位于当前宿主输出目录内”的防守式校验 - - `RequestLifetimeBenchmarks` / `StreamLifetimeBenchmarks` 的 `Scoped` 路径每次 benchmark 调用都会新建 runtime,污染生命周期矩阵公平性 - - `ScopedBenchmarkContainer` 的公共/关键成员 XML 契约说明不完整 - - active tracking / trace 已经偏离“快速恢复入口”,需要归档瘦身 -- 本轮实现选择: - - `Program.cs` - - 把“是否需要重启隔离宿主”统一收敛到 `ArtifactsPath != null` - - 为隔离宿主目录补充“不得等于或嵌套在当前宿主输出目录内”的校验 - - `BenchmarkHostFactory.cs` - - scoped request / stream helper 改为复用单个 runtime,只在调用边界进入和释放 scope - - `ScopedBenchmarkContainer.cs` - - 从“构造时绑定单次 scope”改为“可重复进入的作用域适配器 + `ScopeLease`” - - 补齐只读适配器与作用域租约的 XML 合同说明 - - `RequestLifetimeBenchmarks.cs` - - `Scoped` 路径改为 `GlobalSetup` 时创建单个 scoped runtime - - `StreamLifetimeBenchmarks.cs` - - `Scoped` reflection / generated 路径改为 `GlobalSetup` 时各自创建单个 scoped runtime - - 按语义阶段拆分 `Setup()`,同时清掉 `MA0051` - - `README.md` - - 把 `RequestLifetimeBenchmarks` 的 scoped 语义更新为“复用 runtime,仅每次创建真实 scope” - - `ai-plan/public/cqrs-rewrite/**` - - 将旧 active tracking / trace 复制归档到 - `archive/todos/cqrs-rewrite-migration-tracking-history-through-rp131.md` - 与 - `archive/traces/cqrs-rewrite-migration-trace-history-through-rp131.md` - - 重写 active tracking / trace,只保留当前恢复点、关键结论、风险与验证 - -### 本轮验证 - -- `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` - - 结果:通过,`0 warning / 0 error` -- `dotnet run --project GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release --no-build -- --artifacts-suffix pr347-req-scoped --filter "*RequestLifetimeBenchmarks.SendRequest_GFrameworkCqrs*" --job short --warmupCount 1 --iterationCount 1 --launchCount 1` - - 结果:通过 - - 备注:独立宿主目录位于 `BenchmarkDotNet.Artifacts/pr347-req-scoped/host/...` - - 结果摘要:`Singleton 52.69 ns / 32 B`、`Transient 57.88 ns / 56 B`、`Scoped 144.72 ns / 368 B` -- `dotnet run --project GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release --no-build -- --artifacts-suffix pr347-stream-scoped --filter "*StreamLifetimeBenchmarks.Stream_GFramework*" --job short --warmupCount 1 --iterationCount 1 --launchCount 1` - - 结果:通过 - - 备注:独立宿主目录位于 `BenchmarkDotNet.Artifacts/pr347-stream-scoped/host/...` - - 结果摘要: - - `Singleton + FirstItem`:reflection `108.7 ns / 216 B`,generated `110.1 ns / 216 B` - - `Scoped + FirstItem`:reflection `266.7 ns / 792 B`,generated `267.0 ns / 792 B` - - `Scoped + DrainAll`:reflection `331.6 ns / 856 B`,generated `332.2 ns / 856 B` - -### 当前结论 - -- `Program.cs` 已不再依赖“命令行后缀”这一单一来源决定宿主隔离,环境变量生效路径也会进入隔离宿主。 -- scoped benchmark 的公平性问题已经实质收口:runtime 构造成本不再按每次调用重复计入生命周期矩阵。 -- active tracking / trace 已恢复到可供 `boot` 和后续 PR review 快速进入的体量;历史细节仍可通过新的 archive 文件追溯。 - -### 当前下一步 - -- 推送本轮变更后,重新运行 `$gframework-pr-review`,确认 `PR #347` 的 latest-head open thread 是否已随着新 head 收敛。 - -### 阶段:多波 batch 收口与 benchmark / docs 扩面(CQRS-REWRITE-RP-133) - -- 按 `$gframework-batch-boot` 启动多波 non-conflicting subagent,基线固定为 - `origin/main @ 3b2e6899d5ffdcfb634b28f3846f57528fbf9196 (2026-05-11T12:25:00+08:00)`。 -- 启动前分支累计 diff 为 `0 files / 0 lines`;自然停点时累计 branch diff 约为 `12 files`。 -- 主线程把 stop decision 明确交给 `reviewability / context-budget`,没有在仍有文件预算时继续机械追到 `50 files`。 -- 本轮 accepted delegated scope: - - runtime / tests - - `CqrsNotificationPublisherTests`:补“多 publisher 报错”与“publisher 缓存复用”回归 - - `CqrsGeneratedRequestInvokerProviderTests` + `CqrsHandlerRegistrar`:补 generated descriptor 坏元数据、异常枚举、重复 pair 回退契约 - - `CqrsDispatcherCacheTests`:补 request / stream pipeline presence、executor cache 与上下文重新注入组合分支 - - `CqrsRegistrationServiceTests`:补稳定程序集键 fallback 到 `AssemblyName.Name` / `ToString()` 的回归 - - benchmarks - - `RequestStartupBenchmarks`:补 `Mediator` startup 对照 - - `StreamStartupBenchmarks` - - `NotificationStartupBenchmarks` - - `NotificationLifetimeBenchmarks` - - `GFramework.Cqrs.Benchmarks/README.md`:收口当前 coverage / gap / smoke 解释边界 - - docs / recovery - - `GFramework.Cqrs/README.md` - - `docs/zh-CN/core/cqrs.md` - - `docs/zh-CN/source-generators/cqrs-handler-registry-generator.md` - - `docs/zh-CN/core/command.md` - - `docs/zh-CN/core/query.md` - - `ai-plan/public/cqrs-rewrite/archive/**` 顶部导航与跳转约定 -- 本轮权威验证: - - `dotnet build GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release` - - `dotnet build GFramework.Cqrs/GFramework.Cqrs.csproj -c Release` - - `dotnet build GFramework.Core/GFramework.Core.csproj -c Release` - - `dotnet test GFramework.Cqrs.Tests/GFramework.Cqrs.Tests.csproj -c Release --filter "FullyQualifiedName~CqrsRegistrationServiceTests"` - - `dotnet run --project GFramework.Cqrs.Benchmarks/GFramework.Cqrs.Benchmarks.csproj -c Release --no-build -- --artifacts-suffix notif-lifetime --filter "*NotificationLifetimeBenchmarks*"` -- 本轮 benchmark 结果摘要: - - `RequestStartupBenchmarks` - - `ColdStart_GFrameworkCqrs 61.648 us / 25336 B` - - `ColdStart_Mediator 110.867 us / 57872 B` - - `ColdStart_MediatR 679.103 us / 606256 B` - - `StreamStartupBenchmarks` - - `ColdStart_GFrameworkReflection 71.13 us / 25504 B` - - `ColdStart_GFrameworkGenerated 82.12 us / 28280 B` - - `ColdStart_MediatR 933.87 us / 678992 B` - - `NotificationStartupBenchmarks` - - `ColdStart_GFrameworkCqrs 85.09 us / 24752 B` - - `ColdStart_Mediator 136.08 us / 62512 B` - - `ColdStart_MediatR 1.379 ms / 719056 B` - - `NotificationLifetimeBenchmarks` - - `Singleton`:`GFramework 295.48 ns / 360 B`,`MediatR 77.99 ns / 288 B` - - `Scoped`:`GFramework 410.92 ns / 640 B`,`MediatR 213.49 ns / 632 B` - - `Transient`:`GFramework 311.21 ns / 416 B`,`MediatR 74.36 ns / 288 B` -- 当前收尾判断: - - branch diff 仍远低于 `50` 文件阈值,但 active 未提交面与 benchmark 运行输出已经足够构成自然 stop boundary - - 下一步不继续扩 batch,先提交当前收尾切片并回到干净工作树,再按 PR review 结果决定后续波次 +- 历史说明: + - `RP-143` 的完整执行流水不再保留在 active trace;若后续需要 worker 边界或更细的阶段材料,应把该阶段补入 archive,而不是继续膨胀 active 入口。