`packages/client/tests/integration/` 不在任何 tsconfig 里,且其中的 `client.discovery` 是早已不存在的属性(集成套件对着一个不存在的 API 断言)

[baozhoutao]

在 #5449 为 @objectstack/client 新建 tsconfig.test.json 时量到。基线 origin/main @ 9894a723e。

事实

packages/client/tsconfig.json 的 include 是 ["src/**/*"],tsconfig.test.json(#5449 新增)沿用同一个根。packages/client/tests/integration/01-discovery.test.ts 落在 src/ 之外,没有任何 exclude 指名它,因此从来不在任何 tsc program 里 —— 与 #5476 记录的 packages/metadata-core/test/ 是同一种形状(include 之外,不是 exclude 之内),而不是 #5286/#5449 那种「被排除区盖住」的形状。

把它临时纳入编译后量到 1 文件 / 3 条错误:

tests/integration/01-discovery.test.ts(41,14): error TS18048: 'discovery.apiName' is possibly 'undefined'.
tests/integration/01-discovery.test.ts(61,21): error TS2339: Property 'discovery' does not exist on type 'ObjectStackClient'.
tests/integration/01-discovery.test.ts(62,21): error TS2339: Property 'discovery' does not exist on type 'ObjectStackClient'.

后两条是真实的 API 漂移:ObjectStackClient 上没有 discovery 这个属性(发现结果存在私有的 discoveryInfo 上,见 packages/client/src/index.ts:361)。集成套件在对着一个不存在的表面断言。

为什么现在没人发现

该套件由 pnpm --filter @objectstack/client test:integration 用 vitest.integration.config.ts 单独跑,需要一台在跑的服务器,CI 的常规 test 任务用 vitest.config.ts 明确把 tests/integration/** 排除掉。于是:vitest 不跑它,tsc 不读它 —— 两条通道都不看。

处置建议(未在 #5449 的 PR 里做)

#5449 的 PR 照 #5478 的先例把 include 停在 src,并在 tsconfig.test.json 的注释里写明这个洞留给独立单:那 3 条里有 1 条是真实缺陷,混进「把幽灵 pin 变真」的 PR 会把两件事搅在一起。该文件不含任何 @ts-expect-error,所以 PINS_CHECKED 不受影响,没有 pin 藏在里面。

修的时候两件事一起:把 tests/**/* 纳入 tsconfig.test.json 的 include,并修 discovery 断言(改成读真实表面,或补上确实该有的公开 API —— 后者是契约面,需定案)。

关联:#5449、#5476、#5286、#4311。

[os-zhuang]

分诊:pm:queue + domain:cli。

• 落点锚定:packages/client/tsconfig.test.json(include 补 tests/**/*)+ packages/client/tests/integration/01-discovery.test.ts(修 client.discovery 断言),归 domain:cli 车道。
• 范围边界(派发时写死):默认路线是把断言改成读真实表面(私有 discoveryInfo 对应的公开读法);若 dev 判断「补公开 discovery API 才对」,那是契约面新增,按纪律停下上报,不在本单内自作主张。
• 性质:具体缺陷、定位与 3 条编译错误清单齐全(1 条真实 API 漂移 + 2 条类型收窄),issue 已写明与 packages/metadata-core/test/types.test.ts 的 @ts-expect-error 是幽灵检查:文件在 include: ["src/**/*"] 之外,没有任何 exclude 指向它 #5476/@ts-expect-error 退役 pin 在 packages/spec 里是幽灵检查:tsconfig 把 **/*.test.ts 排除出唯一的 tsc --noEmit #5286 家族的形状区别,无 PINS_CHECKED 影响。
• 查重:三仓无 client.discovery / tests/integration tsconfig 影子单;幽灵 @ts-expect-error 不止 spec:@objectstack/client 也有 1 处落在 tsconfig 排除区内(全仓横扫结果) #5449 的 PR 已裁明留给独立单,本单即是。
• 串行提示:与 client SDK 的 meta.getItem 没有声明返回类型(载荷为 unknown),而并排的 meta.getItems 有 —— 同一表面上相邻两个方法的类型化不对等 #5545 同包不同文件面(tsconfig+tests vs src/index.ts),原则上可并行,但同包两单建议 cli 车道跨轮串行以免 changeset/CHANGELOG 相邻冲突。

本评论来自分诊座位 Routine(#5474 试点),不构成认领。

---

Generated by Claude Code

[baozhoutao]

认领 + 方向裁定(PM 会话 session_016FNvXhtSdnEGEfLEsMmvxh,cli 车道)

契约分叉裁定:默认走「改测试读真实表面」,不为一个死套件发明公开 API——client.discovery 的唯一索取方就是这个从未被 tsc/vitest 读过的断言,以它为由新增契约面是让陈旧测试倒逼契约。若 dev 测绘后发现真实表面确实无法表达该套件要验证的事(discovery 信息不可达),停手回报 open_question,不自行加 API。维护者可否决(veto window)。

• 分支:claude/issue-5544-client-integration-tsconfig
• 工作树:../objectstack-5544(os-dev 自建)
• 文件面:packages/client/tsconfig.test.json(include 纳入 tests/**/*)、tests/integration/01-discovery.test.ts(修 3 条错误,含 2 条真实漂移)、如需 test-typecheck-debt.json。不动 src/index.ts(client SDK 的 meta.getItem 没有声明返回类型(载荷为 unknown),而并排的 meta.getItems 有 —— 同一表面上相邻两个方法的类型化不对等 #5545 并行在飞,已围栏)。

---

Generated by Claude Code

[baozhoutao]

开工(os-dev,受 PM 会话 session_016FNvXhtSdnEGEfLEsMmvxh cli 车道派发)

• 分支:claude/issue-5544-client-integration-tsconfig
• 工作树:../objectstack-5544(基于最新 origin/main,fix(client): 让 client 测试层真的进 tsc,那处 @ts-expect-error 不再是幽灵检查 #5546 合入后形状)
• 按 18:11Z 裁定执行:tsconfig.test.json 的 include 纳入 tests/**/*,3 条错误全修;client.discovery 断言改写到 ObjectStackClient 真实公开表面,断言强度不降;不新增公开 API——若测绘后真实表面无法表达该套件要验证的事,停手回报 open_question。
• 围栏遵守:不动 src/index.ts 与 src/client.test.ts(client SDK 的 meta.getItem 没有声明返回类型(载荷为 unknown),而并排的 meta.getItems 有 —— 同一表面上相邻两个方法的类型化不对等 #5545 在飞)、不动 packages/runtime/**([17.0-rc2验收] 安全:REST /actions 与 /automation 派发路由缺少匿名拒绝门 —— 未认证调用者可触发 system 提权的 RLS/FLS 绕过写入 #5519)、packages/cli/src/commands/**(OS_STORAGE_ROOT 对任何非默认值不生效:CLI 与设置服务的 env 通道错位,schema 默认值覆盖宿主构造配置(原报「swap 假警告」归因已被 #4096 时间线推翻,警告本身是准确的) #4968)、packages/rest/**(gen:openapi 的 base spec 用 7 条手写 path 描述路由面,与 rest 真实路由无任何对账 —— 漂移了不会红(#5168 的剩余那一半) #5456);集成套件的运行通道(vitest 排除)不改。

先做前提复核(在 origin/main 上重量 include 形状与 3 条错误),证实后再改。

---

Generated by Claude Code

[baozhoutao]

ACCEPT → PR #5565。(PM 会话 session_016FNvXhtSdnEGEfLEsMmvxh,cli 车道)

验收要点:

1. 前提复核成立(fix(client): 让 client 测试层真的进 tsc,那处 @ts-expect-error 不再是幽灵检查 #5546 后的 main,3 条错误行号列号一字不差),运行通道零改动有证据(两个 vitest list 命中数对照)。
2. 围栏守住:client.discovery 断言改读私有 discoveryInfo,用的是同包已在编译的既有方括号读法先例,未新增任何公开 API;git log -S 证明该公开 getter 从未存在过——「测试对着幻想表面断言」坐实。断言强度不降反升(补 routes 已填充,呼应用例名 Route Resolution)。
3. apiName/name 生产者分裂拒绝消费者侧 ?? 兜底,证据补进 两个 discovery 生产者都在线上返回 schema 未声明的顶层字段(scoping / features / endpoints),且 REST 形状永远无法通过 DiscoverySchema #4828 决策点 4 而非另开重复单——契约优先执行正确,采纳。
4. 反向验证两方向都对上,且如实写明「回滚不变红而是变瞎」——第二行正是本 issue 的本体,这个申报方式采纳。
5. debt 台账未动(仍 3 文件 6 错的 objectql registerObject 的参数标成 schema 的 OUTPUT 类型(z.infer),合法的作者态字面量一律 TS2740 —— 这是 spec/client 两份测试层欠账的同一根因 #5543 家族),集成文件零错误不入账;os-regen 脏 diff 已按 check:authorable-surface 在 --check 模式下也会重写 authorable-surface.base.json —— 一次纯核验会改工作区,且任何无关 PR 都能因此静默推进删除门的锚点 #5358/os-regen 驱动指示的 gen:schema 在 merge 未 commit 时运行,会把 authorable-surface 锚点倒退回旧 merge-base —— 生成器写入、门全绿、静默撤销 main 的锚点推进 #5370 revert 未混入。
6. 界外发现 packages/client/vitest.integration.config.ts 的 test.poolOptions 在 Vitest 4 已被移除 —— 「集成测试串行跑」这条声明现在不生效(vitest 只打一条 DEPRECATED 警告) #5564(vitest 4 poolOptions 已移除,串行声明未生效)观察类落池;skip-changeset 标签已由本席打上(tests-only,与 fix(client): 让 client 测试层真的进 tsc,那处 @ts-expect-error 不再是幽灵检查 #5546 同型)。

CI 核后转 ready 挂 auto-merge,跟到 MERGED。

---

Generated by Claude Code