Skip to content

[OPS-PTC D4] 对齐自定义 PTC 接入与诊断结果 #988

Closed

Description

@Thatgfsj

D4 · 对齐自定义 PTC 接入与诊断结果

总计划 #978,所属工作流 #979。

问题:自定义接入的 discovery=false 默认池可能为空,和内置行不同;固定写死诊断期望还会把合法缺少的 result 当故障。

前置条件:等待 D3;使用它已验证的集合推导方法。

从哪里读

  • src/consumer/options.ts
  • src/integration/diagnostics.ts
  • test/preset-integration.test.mjs

认领前记录当前 main SHA。以上为优先检查的范围,需要扩大写域时先说明文件与原因。

按顺序执行

  1. 先写三组 fixture:旧自定义行关闭发现、新全量选择未填 allowedTools、新全量选择只填 stat。
  2. 逐组记录解析后的池、真正的首步声明和诊断期望。让诊断跟随发布计划,不再按猜测添加某个 API。
  3. 专门提交一条 alwaysLoaded 超出 allowedTools 的旧输入,按该接入路径已有合同处理,核实没有静默放宽或拒绝保存过的配置。

验收清单

  • 显式窄池不因全量意外变成默认整个池;合法缺少 result 不报假阳性,确实缺少预期项时仍有诊断。
  • Native 自定义 preset 的可见工具前后相同。

范围边界与停手条件:不统一所有组件的验证规则;要变更旧合同先记录影响并停在本单讨论。

验证与交付

先运行 npm run build;依赖 native worker 的测试先运行 npm run build:ptc。定向入口:node test/run.mjs preset-integration。确认过滤器命中目标套件,记录实际 pass / skip / fail。

认领模板:编号 / 当前 SHA / 目标文件 / 第一个失败样例。提交时贴修改前与修改后结果,以及撤掉改动后会失败的断言。已有 PR 请先在原讨论协作。行为及中英文文档同 PR。

Activity

  1. Thatgfsj commented on Nov 19, 2026

    @Thatgfsj
    CollaboratorAuthor

    D4 完成,经 PR #1018 交付(base: card/d3-full-publication,branch card/d4-integration-diagnostics @ 27af626,stacked on D3 d0fcd6f)。

    • 诊断期望集合改由与发布共用的同一份披露计划生成(新模块 src/ptc/disclosure.ts,publication/ptc.ts 与 integration/diagnostics.ts 同读):合法 profile: 'ptc' 行不再误诊 PUBLICATION_UNAVAILABLE: ops_result(result 可选加载而非常驻);显式全量档整池入期望;真正缺失的首轮名仍报告。D1 真值表锁定误报的检查翻转为 ready。
    • 自定义 integration 路径接受与内置行同契约的 disclosurePolicy(缺省回落 on-demand,full 显式 opt-in,Native 展示行拒绝,非法值报错点名键)。
    • 校验差异如实记录并双侧断言:自定义路径 alwaysLoaded∉allowedTools 仍抛 ConfigError,内置行静默接受(两侧各有测试),未做统一。
    • 原生模式以快照保护:native 自定义 preset 的可见工具集逐字断言(含官方 read/glob/grep 并存),修复前后相同。
    • 三个 [OPS-PTC D4] 对齐自定义 PTC 接入与诊断结果 #988 fixture 端到端锁定:旧 discovery:false(空池/仅 inspect/ready)、全量未填上限(整池/无 loader/ready)、全量只填 stat(inspect+stat+result/ready,窄池不放宽成整池)。

    改前红:node test/run.mjs preset-integration 13 项中 5 项失败(未知键×2、ops_result 误诊×2、缺口消息被 result 填充);node test/run.mjs ptc-config-truth 恰失败翻转项(1/13)。改后绿:preset-integration 13/0/0、ptc-config-truth 13/0/0;回归锁不变——integration-diagnostics、ptc-disclosure-policy、ptc-full-disclosure 8/0/0、ptc-declaration-surface、consumer-assembly、publication-reentry-rows、settings-rows 14/0/0、preset-registration 23/0/0、resident-switch 24/0/0、external-discovery 7/0/0。worker 用 DSH_OPS_WORKER_BIN=runtime/linux-x64/dsh-ops-worker(sha256 前缀 2b5f988d)。npm run check:size 通过(825 文件,最长 930 行)。撤回任一改动即红,说明见 PR Validation 段。文档(中英 + CHANGELOG Unreleased + 设计决策 D4 附录)同 PR。

  2. Thatgfsj commented on Nov 20, 2026

    @Thatgfsj
    CollaboratorAuthor

    已由 #1033 合入 main 交付(18 张卡并集,见 PR 描述与 docs/CHANGELOG.md 的 Unreleased 条目)。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions