Repository navigation
Conversation
AI PR Review — ❌ 不可通行
问题清单中
最终总结[2m ▎ thinking�[0m 结论摘要评审收敛情况:两名独立评审(codexcli、claudecli)分别覆盖了 diff 的两半。没有出现任何 P0/P1/高 级别主张,也没有需要驳回的高危误报。 两个 P2 均达成双评审收敛,且我独立核对代码后确认存在具体触发路径:
落级理由:两者都是"契约校验器"自身的漏检,而非运行时崩溃或已证实的线上数据丢失,因此记为 中(P2),不升为 高。但它们被两名独立评审在同一代码切片上以相同根因和相同影响报告,且我独立核实了构造路径与影响链路,故不适用"单评审 P2 可豁免"。两处修复都很小(各加一个非空/非空串校验 + 定向单测)。 已整体抑制的低级别噪音:javadoc 措辞与格式建议、可选 helper/便捷方法的增补、 测试覆盖缺口:全仓 grep 显示这些实体类只在 下一步(最小修复,不做无关重构):
FINAL_VERDICT: BLOCK codexcli (part 1/2) review
VERDICT: BLOCK claudecli (part 1/2) reviewPR #220 Review — Part 1 of 2I've reviewed all files in part 1 of this PR, examining the Trigger CDC API contract models for correctness, validation completeness, concurrency safety, and API design. Finding[P2] Cleanup validation accepts an unusable consumer ID — TriggerCdcCleanupResult.java:75
Impact: After a forced cleanup deletes unacknowledged records, a result listing only Fix: In if (hasIntegrityBrokenConsumers()) {
for (String consumerId : integrityBrokenConsumers) {
if (consumerId == null || consumerId.trim().isEmpty()) {
violations.add("integrity broken consumer list contains null or blank ID: "
+ consumerId + "; framework cannot identify affected tasks");
}
}
}Verification: Construct a ObservationsThe API design shows strong defensive practices:
All data model classes are VERDICT: BLOCK codexcli (part 2/2) review
VERDICT: BLOCK claudecli (part 2/2) reviewI'll conduct a thorough review of part 2 of this PR, examining all changed files for correctness, validation completeness, API design, and potential defects. PR #220 Review — Part 2 of 2I've completed a thorough review of all files in part 2, examining data models, function interfaces, and the connector function registry for correctness, validation completeness, API safety, and data loss risks. Finding[P2] Successful install factory accepts missing generation — TriggerCdcTableResult.java:54 The result.generation = table.getGeneration();A connector can therefore return a successful install with Impact: Without generation, the framework cannot distinguish a stale offset from a previous installation (should be rejected) from a valid offset of the current installation (should be resumed). TriggerCdcEnsureFunction requirements explicitly state: "Running it twice returns the same capture ids and the same generation. Only a real reinstall increments the generation, so a stale offset can be rejected instead of silently resumed." Resuming from the wrong generation risks reading the wrong journal or missing a reinstall boundary, causing data loss or duplication. Fix: In if (table.getGeneration() == null) {
throw new IllegalArgumentException("table " + table.getTableName()
+ " is reported successful but has no generation; stale offsets cannot be rejected");
}Also update Verification: Construct a ObservationsAll other aspects of part 2 are sound:
The API's defensive philosophy—fail closed, validate inputs, explicit outcomes per table—is consistently applied throughout. The generation validation gap is the only break in that pattern. VERDICT: BLOCK reasonix review[2m ▎ thinking�[0m 结论摘要评审收敛情况:两名独立评审(codexcli、claudecli)分别覆盖了 diff 的两半。没有出现任何 P0/P1/高 级别主张,也没有需要驳回的高危误报。 两个 P2 均达成双评审收敛,且我独立核对代码后确认存在具体触发路径:
落级理由:两者都是"契约校验器"自身的漏检,而非运行时崩溃或已证实的线上数据丢失,因此记为 中(P2),不升为 高。但它们被两名独立评审在同一代码切片上以相同根因和相同影响报告,且我独立核实了构造路径与影响链路,故不适用"单评审 P2 可豁免"。两处修复都很小(各加一个非空/非空串校验 + 定向单测)。 已整体抑制的低级别噪音:javadoc 措辞与格式建议、可选 helper/便捷方法的增补、 测试覆盖缺口:全仓 grep 显示这些实体类只在 下一步(最小修复,不做无关重构):
===FINDINGS===
|
| * Reports a consumer whose stream now has a hole. Only valid together with a non zero | ||
| * {@link #getDeletedUnacknowledgedCount()}: a hole can only come from a removed record. | ||
| */ | ||
| public TriggerCdcCleanupResult integrityBrokenConsumer(String consumerId) { |
There was a problem hiding this comment.
[中] Cleanup 结果允许报告不可用的消费者 ID,校验形同虚设
integrityBrokenConsumer(String) 接受 null 或空白 ID,而 validate(TriggerCdcConfig) 在 deletedUnacknowledgedCount > 0 时只检查 integrityBrokenConsumers 非空,从不检查列表元素可用。因此 deletedUnacknowledgedCount(1).integrityBrokenConsumer(null)(或空串)能通过校验,但框架无法把任何任务标记为 integrity broken——这恰好是该字段存在(类注释中明确说"否则连接器可以删掉未确认记录、只报总数、列表留空而无从发现")所要防住的失败模式。强制清理已删除未确认记录后,数据完整性缺口会静默通过。
建议:在 validate() 的 deletedUnacknowledgedCount > 0 分支内遍历 integrityBrokenConsumers,对 null 或 id.trim().isEmpty() 的条目加入 violations,并补一条"含 null ID 的结果校验失败"的单测(本模块当前无任何相关测试)。
| * | ||
| * @throws IllegalArgumentException when {@code table} is null or has no capture id | ||
| */ | ||
| public static TriggerCdcTableResult success(TriggerCdcTable table) { |
There was a problem hiding this comment.
[中] 成功的 install 结果可以不带 generation,stale offset 拒绝机制失去依据
success(TriggerCdcTable) 只校验 captureId 非空,第 67 行把 generation 原样拷贝;isSuccess() 与 TriggerCdcInstallResult.validate(...) 也只检查 captureId / captureId 唯一性。于是连接器可返回 success=true、captureId 存在但 generation == null 的结果并一路通过校验。而 TriggerCdcTable、TriggerCdcOffset 与 TriggerCdcEnsureFunction 的契约都要求 generation 由 ensure 赋值并回传,用于"拒绝过期 offset 而不是静默续读";缺失代次后框架没有可持久化的值,重装边界无法判定,存在从错误采集状态续读(漏读/重复)的风险。
建议:在 success(TriggerCdcTable) 的 captureId 校验之后追加 generation == null 时抛 IllegalArgumentException,并在 TriggerCdcInstallResult.validate(Collection) 的成功分支补一条 generation 缺失的 violation;补一条"captureId 存在但 generation 为 null"的定向单测。
AI PR Review — ✅ 可通行
最终总结[2m ▎ thinking�[0m 终审报告 · PR #220(增量 c729808 → 85384dd)历史发现复核(逐条给出状态,与阻塞判定分开)
两条历史发现均已被新增测试实质性覆盖(不是空断言): 本轮新增变更审查(我自行核对,非继承两位初审结论)
严重性重估与处置
验证限制(如实说明)本轮环境 shell 不可用( 后续无需修复动作;建议合并前由流水线在有依赖的环境跑一次 FINAL_VERDICT: PASS ===FINDINGS=== codexcli (part 1/2) review历史发现复核
本部分新增发现未发现由本部分变更引入的可操作缺陷。检查了本部分的文档、版本 POM、API 删除与签名变更、能力注册条件及结果校验; VERDICT: PASS claudecli (part 1/2) reviewPR #220 增量审查 - Part 1/2已审查从 c729808 到 85384dd 的第 1 部分全部变更。 历史发现复核✅ 已修复 - P2: 清理结果的无效消费者 ID 校验位置: 当前代码已在 if (hasIntegrityBrokenConsumers()) {
for (String consumerId : integrityBrokenConsumers) {
if (consumerId == null || consumerId.trim().isEmpty()) {
violations.add("integrity broken consumer id must not be null or blank");
}
}
}✅ 已修复 - P2: 成功的 install 结果可以不带 generation位置:
现在三个层次都强制要求成功结果必须包含 generation:
历史缺陷已完全修复,且采用了纵深防御设计。 本部分新增审查版本变更 (全部 POM 文件)
API 删除 (符合 PR 描述的窄化目标)删除了 8 个 entity 类和 5 个 function 接口,保留 ensure/acknowledge/cleanup 三个函数 + 复用 StreamReadFunction。 API 签名变更 (破坏性但符合设计)
这些是 2.0.11 → 2.0.12 的协调发布变更,PR 描述已明确要求引擎/连接器同步更新。 其他变更
本部分发现未发现由本部分变更引入的可操作缺陷。已检查:
VERDICT: PASS codexcli (part 2/2) reviewHistorical findings: both 已修复.
I found no new actionable defects in this part’s test and POM changes. The targeted Maven test could not run: the 2.0.12 and 2.12 SNAPSHOT dependencies were unavailable from the configured repository, so Maven stopped during dependency resolution. VERDICT: PASS claudecli (part 2/2) reviewPR #220 增量审查 - Part 2/2已审查从 c729808 到 85384dd 的第 2 部分全部变更。 历史发现复核✅ 已修复 - P2: 清理结果的无效消费者 ID 校验新增测试 ✅ 已修复 - P2: 成功的 install 结果可以不带 generation新增两个测试验证了纵深防御:
两个历史发现的修复均已被本部分新增的测试充分覆盖。 本部分新增审查新增测试文件 (
|
| # | 上轮发现(中) | 状态 | 代码证据 |
|---|---|---|---|
| 1 | Cleanup 结果允许报告不可用的消费者 ID,validate() 形同虚设 |
已修复 | TriggerCdcCleanupResult.java:117-128:在 deletedUnacknowledgedCount > 0 分支内逐项遍历 integrityBrokenConsumers,对 null / trim().isEmpty() 加入 violation;并保留"删了未确认记录但未报消费者"的检查(129-132)与反向检查(133-136) |
| 2 | 成功的 install 结果可以不带 generation,stale offset 拒绝机制失去依据 |
已修复(三层强制) | ① 工厂 TriggerCdcTableResult.success() TriggerCdcTableResult.java:57-59 对 generation == null 抛 IllegalArgumentException;② isSuccess() :117 追加 generation != null;③ TriggerCdcInstallResult.validate() :218-220 对"声称成功但无 generation"记违规 |
两条历史发现均已被新增测试实质性覆盖(不是空断言):successFactoryRejectsMissingGeneration、deserializedSuccessWithoutGenerationIsRejected(后者同时断言 isSuccess()==false、violation 含 "generation"、getCaptureIds() 抛 IllegalStateException)、forceCleanupRejectsNullEmptyAndBlankConsumerIdsEvenAmongValidIds(null / 空串 / 纯空白各自混入 "valid",共三次断言)。我按代码路径逐条推演,测试可通过且断言可失败,覆盖了上轮要求的"混有有效 ID 也不放行"场景。
本轮新增变更审查(我自行核对,非继承两位初审结论)
- 能力注册:
ConnectorFunctions.getCapabilities():243-247要求 ensure / acknowledge / cleanup / streamRead 四者齐备才注册trigger_cdc;getCapabilities()每次重算(:215-222),因此新测试capabilityRequiresAllThreeFunctionsAndExistingStreamReader的 4 步组合断言有效,不会因缓存变成恒真。 - API 收窄后的编译完整性:全仓检索
triggercdc包的 import 与TriggerCdc*类型使用,仅命中现存类与新测试;TriggerCdc(Plan|Inspect|Release|Read|Verify|Snapshot)*无任何残留引用 —— 删除的 8 个 entity / 5 个 function 没有留下悬空调用点。 - 函数签名与测试 lambda 一致:
ensure(ctx, config, consumerId, tables)、acknowledge(ctx, config, consumerId, TriggerCdcOffset)、cleanup(ctx, config)、streamRead(ctx, List<String>, Object, int, StreamReadConsumer)均与测试中四个 lambda 吻合,无类型不匹配。 capabilities变为必需:TriggerCdcInstallResult.validate():174-176在失败结果上也要求非 null,与docs/trigger-cdc.md:6,16-19一致,属协调发布的契约变更,非缺陷。- 版本一致性:全仓已无
2.0.11-SNAPSHOT/ 父2.11-SNAPSHOT残留,26 个 POM 统一为2.0.12-SNAPSHOT/2.12-SNAPSHOT;tapdata-pdk-api/pom.xml新增 surefire 3.2.5,JUnit 5 由plugin-kit/pom.xml父依赖提供,测试模块可编译。
严重性重估与处置
- 两条历史中等问题在现行代码上已不存在,没有可指认的触发路径,故不再作为阻塞项,不进入 FINDINGS。
- 本轮新增的 P0/P1/P2 均为零:两位独立初审(Codexcli、Claudecli)在各自分片上都给出 PASS,我逐点复核代码后未发现分歧点或漏网缺陷。
- 未发现【上轮漏报】级别的具体缺陷:所有"可绕过"路径(
integrityBrokenConsumer(null)、success(true)+ 无 generation、setIntegrityBrokenConsumers(null)、重复 captureId / 重复 outcome / 未请求表 / 无 outcome)都被validate()拦截,且getCaptureIds()采用"违规即抛"而非静默过滤。 - 低严重度噪音(javadoc 措辞、
integrityBrokenConsumer未在 setter 层校验而只在 validate 层校验这类可选加固)按收敛策略统一抑制,不作为评论或修复任务。
验证限制(如实说明)
本轮环境 shell 不可用(bwrap: Creating new namespace failed),因此未执行 Maven 测试,结论基于当前 head 源码的静态推演;Codexcli 侧同样因 2.0.12/2.12 SNAPSHOT 依赖在配置仓库不可得而未能跑通测试。这不影响 PASS:被审查的变更全部是 API 契约与校验逻辑,逻辑路径已逐条核对,且新增测试断言与实现一一对应。
后续
无需修复动作;建议合并前由流水线在有依赖的环境跑一次 mvn -pl plugin-kit/tapdata-pdk-api test 以固化 14 个契约测试的绿色证据。
FINAL_VERDICT: PASS
===FINDINGS===
===END===
· 63417 tok · in 61851 (60928 cached / 923 new) · out 1566 (256 reasoning) · ¥0.0053
标记:✅ 可通行
|
按工作区 PR 元数据规则,请核实并修正两项:
PR 正文和两条提交消息未命中禁用名称规则。 |
ply0011
left a comment
There was a problem hiding this comment.
请先处理 6 项中等严重度的 Trigger CDC 契约问题:
- 启动与确认:
REPAIR_REQUIRED的订阅不能被判为可启动;完整 checkpoint 中未交付事件的条目应持久化,但不应传给acknowledge。 - 清理安全:清理结果必须区分未报告未确认删除数和显式报告
0。 - 身份一致性:保持 capture ID 的原始值;没有稳定 ID 时,不要把不同的带引号表名合并。
- 能力一致性:拒绝相互矛盾的 TRUNCATE 能力声明。
触发条件与修正建议见行内意见。
| watermark. In-memory delivery tracking can avoid continuous duplicates while a checkpoint | ||
| is pending; loss of that tracking after restart safely replays unacknowledged events. | ||
| 5. Only after every destination's writes and the corresponding recoverable checkpoint are | ||
| durable, pass each checkpoint entry to acknowledge. Tokens are bound to consumer, capture |
There was a problem hiding this comment.
[中] 不要确认尚未交付事件的 checkpoint 条目。 完整 checkpoint 含每个 capture 的条目,包括还未产出事件、没有交付 token 的表。比如 orders 已产出而 refunds 尚未产出时,按这里逐项调用 acknowledge 会在 refunds 上被拒绝,因为该接口要求 token。请保留 refunds 条目的持久化,但只把含有有效交付 token 的条目传给 acknowledge。
| /** True only when every requested table was installed or reused successfully and the result is | ||
| * structurally valid (see {@link #validate()}). */ | ||
| public boolean isSuccess() { | ||
| if (!isValid()) { |
There was a problem hiding this comment.
[中] REPAIR_REQUIRED 的订阅不能被判为成功。 当 per-table 结果都报告成功,且 capture ID 和 generation 齐全时,即便订阅状态为 REPAIR_REQUIRED,isSuccess() 仍返回 true。强制清理后,这会让调用方通过启动检查,但 reader 按契约又必须拒绝该订阅。请让这个判定拒绝 REPAIR_REQUIRED,并覆盖身份字段齐全的场景。
| * connector could delete unacknowledged rows, report a total {@code deletedCount}, and leave | ||
| * {@link #getIntegrityBrokenConsumers()} empty with nothing able to tell.</p> | ||
| */ | ||
| protected long deletedUnacknowledgedCount; |
There was a problem hiding this comment.
[中] 未报告未确认删除数不等于报告 0。 例如 connector 只填写 deletedCount(1),不填写 deletedUnacknowledgedCount,原始类型的默认值就会把它当成明确报告了 0;即使关闭 force cleanup 也能通过校验,框架无法强制执行契约要求的清理计数。请区分漏报和显式 0,并拒绝漏报。
| List<String> captureIds = new ArrayList<>(tableResults.size()); | ||
| for (TriggerCdcTableResult tableResult : tableResults) { | ||
| if (tableResult.isSuccessReported()) { | ||
| captureIds.add(tableResult.getCaptureId().trim()); |
There was a problem hiding this comment.
[中] 返回的 capture ID 必须保持原值。 一个合法的 capture ID "orders-journal "(引号内有尾部空格)在这里被返回为 "orders-journal"。如果框架用返回值作为 checkpoint 的 key,恢复时 reader 的精确身份检查可能拒绝该 checkpoint。请不要修改返回的 ID;非空校验与返回原值可以分开。
| return "id:" + sourceTableId.trim(); | ||
| } | ||
| if (tableName != null && !tableName.trim().isEmpty()) { | ||
| return "name:" + tableName.trim(); |
There was a problem hiding this comment.
[中] 匹配结果时不要合并不同的带引号表名。 没有稳定 ID 时,带引号标识符 "orders" 和 "orders " 可以指向不同的表。这里的 trim() 让前者的结果通过后者的请求校验,框架随后可能信任错误表的 capture。请原样匹配此处的表名。
| */ | ||
| public List<String> validate(Collection<TriggerCdcTable> requestedTables) { | ||
| List<String> violations = new ArrayList<>(); | ||
| if (capabilities == null) { |
There was a problem hiding this comment.
[中] 校验两种 TRUNCATE 能力声明的一致性。 当前结果可同时声明 truncateCaptureSupported=true、supports(TRUNCATE)=false 而通过校验。这样按前者可以启用截断捕获,按操作集合处理事件的调用方却会认为不支持。请在接受 ensure 结果前拒绝矛盾声明,或由同一数据源派生这两个值。
AI PR Review — ✅ 可通行
最终总结复核范围本轮 HEAD 与上轮审查的 历史 finding 状态
无遗留 P0/P1/P2 历史 finding。 新增人工评论处理(ply0011, MEMBER, write)两条评论均为 PR 元数据合规要求,不是代码缺陷,无法锚定到任何变更行,因此不进入 FINDINGS、也不构成代码合并阻塞:
验证限制本环境 shell 不可用( 结论
FINAL_VERDICT: PASS ===FINDINGS=== codexcli review历史发现复核上轮记录中的两项历史发现均已修复,当前不构成阻塞:
上轮提及的 setter 层额外校验等低严重度可选加固,按规则合并为一项 P3 抑制;没有未解决的 P0/P1/P2 历史 finding。 本轮结论与评论处理当前 HEAD 与已审查的
VERDICT: PASS claudecli reviewI'll complete my independent review of PR #220, re-verifying the historical findings and addressing the new PR comments.# PR #220 增量审查:85384dd (无代码变更) 我已完成对本轮的独立审查。 历史发现复核两项历史发现均已在上轮修复,当前代码中验证通过: ✅ 已修复:成功安装结果缺少 generation位置: TriggerCdcTableResult.java:57-58 修复证据:
✅ 已修复:清理结果接受无效消费者 ID位置: TriggerCdcCleanupResult.java:117-131 修复证据:
新增 PR 评论处理评论来源: ply0011 (MEMBER, 2026-11-19T04:01:50Z) 评论 1:PR 正文缺少实际 AgenticOps 版本要求: 补充 分析: 这是 PR 元数据规范要求,不是代码缺陷。PR 描述和代码文档均未记录 AgenticOps 版本号。本轮为只读审查,未修改 PR 正文。 结论: 元数据合规性问题,需 PR 作者更新描述;不影响代码审查结论。 评论 2:提交作者元数据命中工具名称禁用规则要求: 修正提交 c729808 和 85384dd 的作者姓名、作者邮箱及关联 GitHub 登录名 证据: 分析: 两次提交的作者信息均为 "OpenAI Codex codex@openai.com",命中工作区工具名称禁用规则。这是提交元数据问题,需要重写提交历史修正作者归属。本轮为只读审查,未改写提交元数据。 结论: 提交元数据合规性问题,需 PR 作者修正;不影响代码质量评估。 本轮代码审查变更范围: 无。当前 HEAD (85384dd) 与上轮审查 HEAD 一致,代码无变更。 OCR 规则合规性:
完整性检查:
未发现任何 P0/P1/P2 代码缺陷。 结论代码质量通过审查。两项元数据问题(AgenticOps 版本缺失、提交作者信息不合规)需要 PR 作者处理,但不阻塞代码合并决策:
VERDICT: PASS reasonix review复核范围本轮 HEAD 与上轮审查的 历史 finding 状态
无遗留 P0/P1/P2 历史 finding。 新增人工评论处理(ply0011, MEMBER, write)两条评论均为 PR 元数据合规要求,不是代码缺陷,无法锚定到任何变更行,因此不进入 FINDINGS、也不构成代码合并阻塞:
验证限制本环境 shell 不可用( 结论
FINAL_VERDICT: PASS ===FINDINGS=== 标记:✅ 可通行 |
AI PR Review — ❌ 不可通行
问题清单中
最终总结仲裁结论(PR #220,head
|
| 项 | 状态 |
|---|---|
| 参与评审 | codexcli(BLOCK)、claudecli(BLOCK,确认 codexcli 的 finding) |
| 我的独立核对 | 直接读 head 源码:TriggerCdcInstallResult.java、TriggerCdcTableResult.java、TriggerCdcStatus.java、TriggerCdcEnsureFunction.java、docs/trigger-cdc.md、TriggerCdcContractTest.java |
| 未能执行 | 本环境 shell 不可用(bwrap: Creating new namespace failed: Operation not permitted),无法自行跑 mvn test。codexcli 报告 20 个 TriggerCdcContractTest 通过为外部证据;下列结论基于我读到的代码事实 |
保留的材料性缺陷(1 项,中)
[中] INSTALLING 被当作可用的 ensure 结果
- 代码事实:
TriggerCdcInstallResult.java:180只拒绝REPAIR_REQUIRED与FAILED;INSTALLING通过validate()。isSuccess()(L112-122)走isValid()→validate(),因此对"每张表都 success"的矛盾报告返回true;getCaptureIds(Collection)(L431-444)只在validate()有违规时才抛,故此时返回可读 capture 列表。 - 语义证据:
TriggerCdcStatus.java:13-14定义INSTALLING为"Objects / triggers are being created",即 trigger 尚未 live;TriggerCdcEnsureFunction的契约是"Installs and verifies capture objects ... before snapshot/read",docs/trigger-cdc.md:16-19要求"require every table to succeed before starting the task"。以INSTALLING状态启动读取会漏掉安装期间(trigger 建立前)提交的变更——静默漏事件,与该类 fail-closed 校验("checked as data rather than trusted as prose")的设计目标直接冲突,也与同函数对REPAIR_REQUIRED的处理不对称。 - 共识:两位独立评审者(codexcli、claudecli)报告同一根因与同一影响,我独立复核确认可触发路径存在,故不适用 P2 豁免。
- 现有测试
unusableSubscriptionStatusRejectsOtherwiseCompleteInstall(TriggerCdcContractTest.java:145-157)只枚举两个被拒状态并把CAPTURING当作可接受,缺口未被覆盖。
历史发现逐条状态
| 历史发现(ply0011) | 状态 | 代码证据 |
|---|---|---|
REPAIR_REQUIRED 不能被判为成功 |
已修复 | TriggerCdcInstallResult.java:180-182 拒绝该状态;测试断言 isSuccess() 为 false 且 getCaptureIds() 抛 IllegalStateException |
| 完整 checkpoint 中未交付事件的条目不应 acknowledge | 部分修复(不阻塞) | docs/trigger-cdc.md:31-36 已明确"只把含有效 token 的条目传入 acknowledge,无 token 条目留在 checkpoint";引擎侧 HazelcastSourcePdkDataNode.generateStreamReadConsumer 的强制属本 PR 明示的范围外 follow-up(文档 42-46 行),本仓库无该调用点 |
| 未报告未确认删除数 ≠ 报告 0 | 已修复 | 字段为可空 Long,validate() 对 null 早退并计违规(TriggerCdcCleanupResult.java:111 附近);测试覆盖漏报、显式 0、显式 null |
| capture ID 必须保持原值 | 已修复 | TriggerCdcInstallResult.java:227-233、getCaptureIds L437-443 原值入列,无 trim;hasCaptureId()(TriggerCdcTableResult.java:121-123)仅用 trim 判空不改值 |
| 无稳定 ID 时表名必须精确匹配 | 已修复 | tableKey L298-306 返回 "name:" + tableName 原值,trim 只用于空白判定 |
| 两种 TRUNCATE 能力声明必须一致 | 已修复 | TriggerCdcInstallResult.java:176-178 校验布尔能力与操作集合一致 |
抑制的低等级项(不展开、不作为评论)
status 字段未校验 null;validate() 在计数缺失时提前返回导致后续消息不再枚举;deletedUnacknowledgedCount 由 long 改 Long 的兼容性变化——均无材料性影响,按收敛策略抑制,不重复出 finding。
人类评论
ply0011 的两项 PR 元数据要求(正文补写实际 AgenticOps 版本 <版本号>、修正 c729808/85384dd 的作者姓名/邮箱/关联登录名)属流程与提交元数据,无法从代码 diff 验证,也不是代码缺陷,不作为阻塞 finding;需作者在合并前处理。
下一步
- 最小修复:把状态校验改为对
INSTALLING也拒绝(建议白名单CAPTURING/SNAPSHOTTING/STREAMING/DEGRADED,或至少扩展 L180 的条件),并补一个回归用例(INSTALLING+ 全部 per-table success 时isSuccess()为 false、getCaptureIds()抛IllegalStateException)。 - 作者合并前处理上述 PR 元数据两项。
- 既有 follow-up:引擎侧把"durable checkpoint 才允许 acknowledge"接入
HazelcastSourcePdkDataNode,非本 PR 范围。
FINAL_VERDICT: BLOCK
codexcli review
Finding
- [P2] Reject
INSTALLINGas a successful ensure result.TriggerCdcInstallResult.javarejectsREPAIR_REQUIREDandFAILED, but acceptsINSTALLING. With successful per-table results,isSuccess()can therefore return true andgetCaptureIds()can return a readable capture list while the subscription’s objects or triggers are still being created. The status enum definesINSTALLINGas creation in progress; starting reads then could miss changes before capture is live. RejectINSTALLINGand add a regression case.
Previous concerns and comments
REPAIR_REQUIREDcannot pass as success — 已修复. Validation rejects it, and the added test checks that success and capture ID retrieval fail for otherwise complete results.- Keep tokenless checkpoint entries but do not acknowledge them — 部分修复. The updated lifecycle text says to persist the full checkpoint and acknowledge only entries with a valid token (
trigger-cdc.md). This repository has no engine call site enforcing that rule; the documentation identifies engine integration as follow-up work. - Require an explicit unacknowledged-deletion count — 已修复. A null count produces a validation violation (
TriggerCdcCleanupResult.java); tests cover omitted, explicit zero, and null reset cases. - Preserve capture IDs exactly — 已修复. IDs are checked for blankness, then retained without trimming in validation and returned capture IDs (
TriggerCdcInstallResult.java). - Match fallback table names exactly — 已修复.
tableKeypreserves the original name in the key (TriggerCdcInstallResult.java). - Reject conflicting TRUNCATE declarations — 已修复. Validation compares the boolean capability with the operation declaration (
TriggerCdcInstallResult.java). - Reject invalid cleanup consumer IDs, including mixed lists — satisfied. Validation checks every listed ID, and the test covers invalid entries mixed with a valid one (
TriggerCdcCleanupResult.java). - PR version and author metadata requests — not code findings; not changed in this read-only review. The local Git headers for the two cited commits show the same author identity; the GitHub login and current PR body could not be verified because
ghis unavailable. I did not rewrite commit metadata or edit the PR body.
The focused Maven test passed: 20 TriggerCdcContractTest tests, with no failures or errors. The incremental diff has no build-file changes.
VERDICT: BLOCK
claudecli review
Codexcli's finding is confirmed. validate() at line 180 only blocks REPAIR_REQUIRED and FAILED. INSTALLING ("Objects/triggers are being created") is accepted, so isSuccess() can return true and getCaptureIds() can return a list while captures aren't live yet — a reader starting then could miss committed changes.
仲裁结论(PR #220,head 0f8ca01,增量 vs 85384dd)
新引入问题
[P2] INSTALLING 状态不应被视为可用结果
TriggerCdcInstallResult.java:180 拒绝了 REPAIR_REQUIRED 和 FAILED,但放行了 INSTALLING。TriggerCdcStatus.INSTALLING 的 Javadoc 明确说明"Objects/triggers are being created"——此时 trigger 尚未 live,调用方若此时开始读取会漏掉在安装期间提交的变更。两位评审者此前通过的理由是"所有6项历史发现均已修复",但这是本轮新引入的遗漏,属 P2。
修复建议:将拒绝条件扩展为 INSTALLING,并补充一个回归用例(INSTALLING 状态下所有 per-table 结果齐全时 isSuccess() 返回 false,getCaptureIds() 抛出 IllegalStateException)。
历史发现状态
六项历史发现均已修复,独立代码核查与 codexcli/claudecli 结论一致(详见上轮仲裁,此处不赘述)。
结论
FINAL_VERDICT: BLOCK
===FINDINGS===
[P2] INSTALLING accepted as a usable ensure result — TriggerCdcInstallResult.java:180 blocks only REPAIR_REQUIRED/FAILED; INSTALLING passes validate() and allows getCaptureIds() to return while triggers are still being created.
===END===
reasonix review
仲裁结论(PR #220,head 0f8ca01,增量 85384dd → 0f8ca01)
复核方式与证据边界
| 项 | 状态 |
|---|---|
| 参与评审 | codexcli(BLOCK)、claudecli(BLOCK,确认 codexcli 的 finding) |
| 我的独立核对 | 直接读 head 源码:TriggerCdcInstallResult.java、TriggerCdcTableResult.java、TriggerCdcStatus.java、TriggerCdcEnsureFunction.java、docs/trigger-cdc.md、TriggerCdcContractTest.java |
| 未能执行 | 本环境 shell 不可用(bwrap: Creating new namespace failed: Operation not permitted),无法自行跑 mvn test。codexcli 报告 20 个 TriggerCdcContractTest 通过为外部证据;下列结论基于我读到的代码事实 |
保留的材料性缺陷(1 项,中)
[中] INSTALLING 被当作可用的 ensure 结果
- 代码事实:
TriggerCdcInstallResult.java:180只拒绝REPAIR_REQUIRED与FAILED;INSTALLING通过validate()。isSuccess()(L112-122)走isValid()→validate(),因此对"每张表都 success"的矛盾报告返回true;getCaptureIds(Collection)(L431-444)只在validate()有违规时才抛,故此时返回可读 capture 列表。 - 语义证据:
TriggerCdcStatus.java:13-14定义INSTALLING为"Objects / triggers are being created",即 trigger 尚未 live;TriggerCdcEnsureFunction的契约是"Installs and verifies capture objects ... before snapshot/read",docs/trigger-cdc.md:16-19要求"require every table to succeed before starting the task"。以INSTALLING状态启动读取会漏掉安装期间(trigger 建立前)提交的变更——静默漏事件,与该类 fail-closed 校验("checked as data rather than trusted as prose")的设计目标直接冲突,也与同函数对REPAIR_REQUIRED的处理不对称。 - 共识:两位独立评审者(codexcli、claudecli)报告同一根因与同一影响,我独立复核确认可触发路径存在,故不适用 P2 豁免。
- 现有测试
unusableSubscriptionStatusRejectsOtherwiseCompleteInstall(TriggerCdcContractTest.java:145-157)只枚举两个被拒状态并把CAPTURING当作可接受,缺口未被覆盖。
历史发现逐条状态
| 历史发现(ply0011) | 状态 | 代码证据 |
|---|---|---|
REPAIR_REQUIRED 不能被判为成功 |
已修复 | TriggerCdcInstallResult.java:180-182 拒绝该状态;测试断言 isSuccess() 为 false 且 getCaptureIds() 抛 IllegalStateException |
| 完整 checkpoint 中未交付事件的条目不应 acknowledge | 部分修复(不阻塞) | docs/trigger-cdc.md:31-36 已明确"只把含有效 token 的条目传入 acknowledge,无 token 条目留在 checkpoint";引擎侧 HazelcastSourcePdkDataNode.generateStreamReadConsumer 的强制属本 PR 明示的范围外 follow-up(文档 42-46 行),本仓库无该调用点 |
| 未报告未确认删除数 ≠ 报告 0 | 已修复 | 字段为可空 Long,validate() 对 null 早退并计违规(TriggerCdcCleanupResult.java:111 附近);测试覆盖漏报、显式 0、显式 null |
| capture ID 必须保持原值 | 已修复 | TriggerCdcInstallResult.java:227-233、getCaptureIds L437-443 原值入列,无 trim;hasCaptureId()(TriggerCdcTableResult.java:121-123)仅用 trim 判空不改值 |
| 无稳定 ID 时表名必须精确匹配 | 已修复 | tableKey L298-306 返回 "name:" + tableName 原值,trim 只用于空白判定 |
| 两种 TRUNCATE 能力声明必须一致 | 已修复 | TriggerCdcInstallResult.java:176-178 校验布尔能力与操作集合一致 |
抑制的低等级项(不展开、不作为评论)
status 字段未校验 null;validate() 在计数缺失时提前返回导致后续消息不再枚举;deletedUnacknowledgedCount 由 long 改 Long 的兼容性变化——均无材料性影响,按收敛策略抑制,不重复出 finding。
人类评论
ply0011 的两项 PR 元数据要求(正文补写实际 AgenticOps 版本 <版本号>、修正 c729808/85384dd 的作者姓名/邮箱/关联登录名)属流程与提交元数据,无法从代码 diff 验证,也不是代码缺陷,不作为阻塞 finding;需作者在合并前处理。
下一步
- 最小修复:把状态校验改为对
INSTALLING也拒绝(建议白名单CAPTURING/SNAPSHOTTING/STREAMING/DEGRADED,或至少扩展 L180 的条件),并补一个回归用例(INSTALLING+ 全部 per-table success 时isSuccess()为 false、getCaptureIds()抛IllegalStateException)。 - 作者合并前处理上述 PR 元数据两项。
- 既有 follow-up:引擎侧把"durable checkpoint 才允许 acknowledge"接入
HazelcastSourcePdkDataNode,非本 PR 范围。
FINAL_VERDICT: BLOCK
===FINDINGS===
[中] plugin-kit/tapdata-pdk-api/src/main/java/io/tapdata/pdk/apis/entity/triggercdc/TriggerCdcInstallResult.java:180
INSTALLING 状态被当作可用的 ensure 结果
validate() 只拒绝 REPAIR_REQUIRED 与 FAILED,INSTALLING 通过校验。isSuccess() 因此可在所有 per-table 结果都成功时返回 true,getCaptureIds() 也返回可读 capture 列表。但 TriggerCdcStatus.INSTALLING 的语义是"Objects / triggers are being created",trigger 尚未 live;此时启动读取会漏掉安装期间提交的变更(静默数据丢失),与 docs/trigger-cdc.md 要求的"每张表成功后才能启动任务"冲突,也与同函数对 REPAIR_REQUIRED 的拒绝不对称。
建议:将 L180 的状态判定扩展为拒绝 INSTALLING(或改为只接受 CAPTURING/SNAPSHOTTING/STREAMING/DEGRADED 的白名单),并在 TriggerCdcContractTest 补一个回归用例:INSTALLING 且 per-table 全部成功时 isSuccess() 为 false、getCaptureIds() 抛 IllegalStateException。
===END===
标记:❌ 不可通行
| != capabilities.supports(TriggerCdcOperation.TRUNCATE)) { | ||
| violations.add("truncateCaptureSupported must agree with the TRUNCATE operation declaration"); | ||
| } | ||
| if (status == TriggerCdcStatus.REPAIR_REQUIRED || status == TriggerCdcStatus.FAILED) { |
There was a problem hiding this comment.
[中] INSTALLING 状态被当作可用的 ensure 结果
validate() 只拒绝 REPAIR_REQUIRED 与 FAILED,INSTALLING 通过校验。isSuccess() 因此可在所有 per-table 结果都成功时返回 true,getCaptureIds() 也返回可读 capture 列表。但 TriggerCdcStatus.INSTALLING 的语义是"Objects / triggers are being created",trigger 尚未 live;此时启动读取会漏掉安装期间提交的变更(静默数据丢失),与 docs/trigger-cdc.md 要求的"每张表成功后才能启动任务"冲突,也与同函数对 REPAIR_REQUIRED 的拒绝不对称。
建议:将 L180 的状态判定扩展为拒绝 INSTALLING(或改为只接受 CAPTURING/SNAPSHOTTING/STREAMING/DEGRADED 的白名单),并在 TriggerCdcContractTest 补一个回归用例:INSTALLING 且 per-table 全部成功时 isSuccess() 为 false、getCaptureIds() 抛 IllegalStateException。
AI PR Review — ✅ 可通行
最终总结结论摘要本轮增量( 上一轮 finding 状态
本轮评审分歧的裁决Codex 的 [中] 序列化兼容性 —— 驳回(非 material defect)。 我独立核查了事实链:
结论:该 P2 属“单评审 + 无 material impact”,按收敛策略豁免,不计入 FINDINGS。 人类评论(ply0011)处理6 项行内意见均已在当前代码/文档中落实:
两项 PR 元数据要求仍未完成:PR 正文没有 验证说明与局限本环境 下一步
FINAL_VERDICT: PASS ===FINDINGS=== codexcli review
Previous finding: The Human comments: The generation/factory and result-validation concern is covered by the current contract tests. Forced cleanup checks each affected consumer ID, including invalid IDs mixed with valid ones. The checkpoint concern is addressed in the contract documentation: retain the complete checkpoint and acknowledge only entries with valid tokens after writes and checkpoint persistence; engine execution remains outside this change. The requests to edit the PR body and commit metadata are outside this read-only code review. The supplied PR text lacks the requested AgenticOps version line. Local metadata shows both cited commits authored and committed as “OpenAI Codex”; a GitHub login association cannot be verified from this checkout. Verification: The focused Maven contract test passed: 21 tests, 0 failures, errors, or skips. VERDICT: BLOCK claudecli reviewI'll review the incremental changes from PR #220 — Incremental Review (0f8ca01 → f8a0ca5)Previous finding status[中]
Codex finding from previous round: serialization incompatibilityDismissed — not an actionable defect. Codex flagged that changing New changes: assessment
No new P0–P2 defects found in the incremental changes. Human comment resolution (
|
| 上一轮 finding | 状态 | 证据 |
|---|---|---|
[中] INSTALLING 被当作可用 ensure 结果 |
已修复 | TriggerCdcInstallResult.java:180-183 现同时拒绝 INSTALLING、REPAIR_REQUIRED、FAILED;测试 unusableSubscriptionStatusRejectsOtherwiseCompleteInstall(L145-167)覆盖三个被拒状态 + 四个合法状态,并验证两个 getCaptureIds 重载都抛 IllegalStateException。 |
| 上一轮 P3 项(命名/文档措辞/风格等) | 统一抑制 | 按本轮收敛策略,低严重度项不再逐条重列,也不构成阻断。 |
本轮评审分歧的裁决
Codex 的 [中] 序列化兼容性 —— 驳回(非 material defect)。 我独立核查了事实链:
- 该类在 merge base
b3a4dc7c中不存在:raw.githubusercontent.com/.../b3a4dc7c/.../TriggerCdcCleanupResult.java返回 404,而同一 commit 的pom.xml返回 200(证明 ref 有效、网络正常)。 - 该类在上一轮 head
0f8ca01中才存在,字段为Long;本轮才改为long。因此唯一可能存在的“旧字节流”只会产生于同一未合并 PR 的中间快照。 - 版本为
2.0.12-SNAPSHOT,PR 未发布、未部署;我搜索了整个plugin-kit,没有任何代码持久化或序列化TriggerCdcCleanupResult(仅作为cleanup的返回值在进程内传递)。getDeletedUnacknowledgedCount()/setDeletedUnacknowledgedCount(...)的源级调用仍可用(long可自动装箱为Long),唯setDeletedUnacknowledgedCount(null)不再编译,而这正是契约要拒绝的“漏报”用法。 - Codex 的复现是用旧 class 自造字节流,只证明理论不兼容,未建立真实触发路径与影响;Claude 的反驳与上述事实一致。
结论:该 P2 属“单评审 + 无 material impact”,按收敛策略豁免,不计入 FINDINGS。
人类评论(ply0011)处理
6 项行内意见均已在当前代码/文档中落实:
REPAIR_REQUIRED不可判成功 —TriggerCdcInstallResult.java:180已拒绝,含测试。- 未交付 token 的 checkpoint 条目 —
docs/trigger-cdc.md:31-36明确“完整持久化,但只把有有效 token 的条目传给acknowledge”。 - 漏报 vs 显式
0—deletedUnacknowledgedCountReported标志 +validate()早退;测试cleanupRequiresExplicitUnacknowledgedCountIncludingZero覆盖两种情况。 - capture ID 保持原值 —
getCaptureIds()直接add(getCaptureId()),不过滤/trim;测试captureIdsRetainWhitespaceAndRemainDistinct。 - 无稳定 ID 时表名精确匹配 —
tableKey()用原始tableName/sourceTableId,不 trim;测试tableNamesWithoutStableIdsMustMatchExactly、stableTableIdsMustMatchExactly。 - TRUNCATE 声明一致性 —
TriggerCdcInstallResult.java:176-178双向校验;测试truncateDeclarationsMustAgreeInBothDirections。
两项 PR 元数据要求仍未完成:PR 正文没有 AgenticOps 版本 <实际版本号> 行(trigger220-pr.json 中无 AgenticOps 匹配);f8a0ca5 等提交作者仍为 OpenAI Codex <codex@openai.com>(compare API 显示 author login codex)。这属于作者侧 rebase/正文编辑与流程合规,不是代码缺陷,也无法由只读代码审查完成;合并前需作者处理,但不改变代码审查结论。
验证说明与局限
本环境 bash 不可用(bwrap: Creating new namespace failed),我无法自行执行 Maven。静态核查确认测试与实现签名一致(含新增的 cleanupCountAccessorsRetainPrimitiveSignatures),且两位独立评审均报告同一组 21 个契约测试 0 失败。合并前建议在正常环境重跑:mvn -pl plugin-kit/tapdata-pdk-api -am test -Dtest=TriggerCdcContractTest。
下一步
- 作者处理 PR 正文版本行与提交作者元数据(流程合规,非代码)。
- 合并时依赖方(engine/manager、connectors)需按
long签名重新编译,勿传null。
FINAL_VERDICT: PASS
===FINDINGS===
===END===
标记:✅ 可通行
AI PR Review — ✅ 可通行
最终总结评审摘要 — PR #220 增量(f8a0ca5 → bcd0649)结论:PASS。 本轮增量为收紧契约校验,未见新增可操作缺陷;ply0011 的 6 项中危意见在当前 head 均已修复并有回归测试覆盖。 历史意见逐项复核(代码证据)
本轮新增改动的核查(未发现缺陷)
抑制与豁免
验证限制(如实说明)本环境 下一步无必须修复项。合并前可选动作:按维护者要求在 PR 正文补实际 FINAL_VERDICT: PASS ===FINDINGS=== codexcli review增量代码审查没有发现本轮新增的可操作代码缺陷。此前报告的契约问题均已修复,相关代码和回归测试仍在当前 head 中。
本轮新增的 ensure 校验也拒绝缺失或空白的数据库类型、版本,以及未声明 STRICT 的能力结果;缺失状态同样会被拒绝。测试覆盖了这些路径。TriggerCdcInstallResult.java PR 评论中的元数据请求这两项不是代码缺陷,但目前仍未满足:GitHub 上可见的 PR 正文列出了 Tapdata artifact 版本,却没有 验证
VERDICT: PASS claudecli reviewI'll review the incremental changes for PR #220 from f8a0ca5 to bcd0649.The incremental diff is clean. Here is the full analysis: Review: PR #220 incremental (f8a0ca5 → bcd0649)Historical findings — all resolvedAll six findings from the previous review rounds (ply0011's inline comments) were addressed by f8a0ca5 and remain correctly fixed at the current head. The incremental commit adds further tightening on top of those fixes; no regression introduced. New changes in this commit
Status check converted from denylist to allowlist.
Tests.
The result fixture helper is updated to include 23 tests pass, 0 failures, 0 errors, 0 skipped (confirmed by local Maven run above). No actionable P0–P2 defects found. VERDICT: PASS reasonix review评审摘要 — PR #220 增量(f8a0ca5 → bcd0649)结论:PASS。 本轮增量为收紧契约校验,未见新增可操作缺陷;ply0011 的 6 项中危意见在当前 head 均已修复并有回归测试覆盖。 历史意见逐项复核(代码证据)
本轮新增改动的核查(未发现缺陷)
抑制与豁免
验证限制(如实说明)本环境 下一步无必须修复项。合并前可选动作:按维护者要求在 PR 正文补实际 FINAL_VERDICT: PASS ===FINDINGS=== 标记:✅ 可通行 |
Trigger CDC now adds only three connector functions: ensure, acknowledge and cleanup. Reading reuses StreamReadFunction and TapEvent; database/version capabilities are returned by ensure. Remove the separate plan, capability-query, read, inspect and release APIs and their unused models (8 → 3 functions, 23 → 13 models).
Ensure registers a stable consumer and verifies captures before reading. Stream checkpoints carry a complete capture-to-offset map, with cumulative delivery tokens bound to consumer/capture/generation. Acknowledge is allowed only after all downstream writes and the recoverable checkpoint are durable; callback return alone does not permit journal deletion. Engine integration and database implementations remain follow-up work. SQL preview/manual installation and automatic subscription/object removal are deferred. See docs/trigger-cdc.md for the lifecycle and engine call-chain findings.
Fix both existing review findings: successful installation requires generation through the factory, isSuccess and result validation; forced cleanup rejects null/empty/blank affected consumer ids, including invalid entries mixed with valid ids.
Upgrade all common-lib API artifacts to 2.0.12-SNAPSHOT and the parent/runner/modules/error-code release family to 2.12-SNAPSHOT. Companion engine/manager and connector references have also been updated in their local workspaces and need to land with this release. No artifacts were deployed.
Validation:
Review fixes in 0f8ca01:
Latest fixes in f8a0ca5:
mvn -B -pl plugin-kit/tapdata-pdk-api -am test -Dtest=TriggerCdcContractTest -Dsurefire.failIfNoSpecifiedTests=falsepassed all 21 contract tests (0 failures/errors/skips);git diff --checkpassed.