Skip to content

docs: 合并后对账 CI 状态并修正共享类可见性 - #2

Merged
wubing7755 merged 2 commits into
devfrom
docs/dev-merge-followup
Nov 5, 2026
Merged

wubing7755 merged 2 commits into
devfrom
docs/dev-merge-followup

Conversation

@wubing7755

@wubing7755 wubing7755 commented Nov 5, 2026 •

Copy link
Copy Markdown
Member

背景

PR #1 已于 2026-11-05 15:28 合并(squash 为 f07a096),dev 首次 push 门禁 run 41987481649 两个 job 均 success。dev 受保护,本批改动从最新 dev 另开分支、另开 PR。

改动

  • 修正上批引入的可见性问题:Text/EditDistance.cs 与 Values/JsonValueConverter.cs 上批误写成 public,反向扩大了 public 面,与 F 裁决方向相悖。改回 internal(项目已配置 InternalsVisibleTo,测试不受影响),并新增 SharedHelpers_AreNotPartOfThePublicApi 反射断言防止回退。
  • 文档对账:合并后以下陈述已失真,按事实重写
    • CHANGELOG.md:删掉「working-copy edits … uncommitted」「dev has not triggered CI yet」,改为列出全部四次真实 CI 运行(41977057618 / 41981780325 / 41986150317 / 41987481649)。
    • docs/limitations.md:dev 分支已有绿灯 run,不再写「has not had a run yet」。
    • docs/review-v1-grill.md §15:移除过时的「精度边界」,更新为合并后复核(PR chore(ci): 让 Gate 2 覆盖 dev 并对齐仓库状态 #1 MERGED、dev push 首绿、改后 workflow 已在 PR 与 push 两种事件下跑绿),重列仍待执行项;§16 补记 internal 修正。
  • 「Nothing is released yet」「Pages demo 未部署」等仍成立的陈述保留。

本地验证

  • dotnet build ActionLens.sln -v q --nologo → 0 errors / 0 warnings
  • dotnet format ActionLens.sln --verify-no-changes → 0
  • Core 1417 / 1417(+1 可见性护栏)
  • Ui 25 / 25
  • npm run test:e2e → 8 / 8

无 workflow 配置改动;CI 会由 pull_request 事件照常触发。

仍待执行(未在本 PR)

dev → main 评审 PR、Pages 首次部署与首个 release、§16 留下的「收窄 public 面 / 拆超长文件」、ADR 0003 Deferred 产品功能(Q2 已否决,须重开 ADR)。


追加提交 49a3450 — 收窄 public 面并修复不一致 graph 导致的异常

按「继续推进、先不合并」的要求,本 PR 继续承载后续改动;未合并。

  • 复现并修复 §7 记录但未被测试覆盖的真实缺陷:ScenarioEngine.Run 接受独立的
    workflow 与 graph,外部传入不匹配的一对会抛裸 KeyNotFoundException。新增
    ScenarioEngineMismatchTests 复现(one.yml 模型 + two.yml graph);A/B 验证确认
    恢复裸索引后该用例重新失败。
  • 修复方式:ScenarioEngine 收窄为 internal,WorkflowAnalyzer 成为唯一 public 入口;
    ScenarioRunner 在遍历前用 _jobs.ContainsKey 过滤无法定位的 id,并为每个产出
    INT001 / Internal / Error 诊断说明原因。不抛异常,也不给无定义的 job 编造结果。
  • 批量收窄 public 面(F 裁决):41 个「外部程序集从未按名字引用」的 Core public 类型
    批量改为 internal,按编译器 CS0050/51/53/60 的可访问性错误迭代回退 3 轮收敛。
    最终 27 个收窄(含 LintEngine),15 个保留 public——它们出现在 public 签名里,
    是 JSON 导出与 UI 真正依赖的契约。边界由编译器决定,不靠猜测。
  • PublicSurfaceTests(11 条断言)钉住该边界,防止未来「改成 public 更方便」的回退。

验证(追加提交后):dotnet build 0/0 · dotnet format --verify-no-changes 0 ·
Core 1430 / 1430 · Ui 25 / 25 · Playwright 8 / 8 ·
本 PR CI run 42000411644 两 job 均 success。

仍未做:拆超长文件(WorkflowModelBuilder 1444 行等,纯机械重构)、Pages 首次部署与
首个 release、ADR 0003 Deferred 产品功能(Q2 已否决,须重开 ADR)。

- EditDistance / JsonValueConverter 由 public 改回 internal,避免反向扩大 public 面(F 裁决)
- 新增 SharedHelpers_AreNotPartOfThePublicApi 护栏断言
- CHANGELOG / limitations / review-v1-grill §15 更新为合并后的真实状态:PR #1 已 MERGED 为 f07a096,dev 首次 push CI (41987481649) 通过
- 移除过时的「改动未提交 / dev 从未触发 CI」等精度边界,重列仍待执行项
- 复现 §7 记录的缺陷:ScenarioEngine.Run 接受独立的 workflow 与 graph,外部传入不匹配的一对会抛 KeyNotFoundException
- ScenarioEngine 收窄为 internal,WorkflowAnalyzer 成为唯一 public 入口;ScenarioRunner 过滤无法定位的 job id 并为每个产出 INT001/Internal/Error 诊断,不抛异常也不编造结果
- 批量收窄 27 个实现细节类型为 internal;边界由编译器的可访问性规则决定,15 个被 public 签名引用的契约类型保留 public
- 新增 ScenarioEngineMismatchTests(含 A/B 复现)与 PublicSurfaceTests(11 条护栏断言)
- §17 / CHANGELOG 记录边界判定方法与仍未做的拆超长文件
@wubing7755
wubing7755 merged commit d6b5eba into dev Nov 5, 2026
2 checks passed
@wubing7755
wubing7755 deleted the docs/dev-merge-followup branch November 6, 2026 04:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant