test(cli): pin os serve config-boot for the authored shape #3887 reported

[os-zhuang]

一句话

#3887 报的崩溃早已被 #4110(closes #4085)修好,但它报的那个形态从来没有被测试钉住。本 PR 补上那一次 boot,并顺带把 #3887 关掉。

事实核实(不是推断)

按 issue 里逐字的复现跑了一遍当前 main:

Loading objectstack.config.ts...
✓ Server is ready
Plugins: 29 loaded
         … com.objectstack.metadata, ObjectQL, cfgload, RestAPI, …

Service 'manifest' is async - use await 没有了,artifact read FAILED 也没有了(后者在 #4110 里被改成 ENOENT 时的正常 no compiled artifact at …)。

而且不止「没崩」——登录后对 cfg_note 做了真实读写,确认对象是真的在服务:

POST /api/v1/data/cfg_note  → {"id":"cfg_note-…","title":"hello 3887", …}
GET  /api/v1/data/cfg_note  → {"records":[…],"total":1}

#4110 没有 link #3887,所以它一直挂着 OPEN。

为什么还要加测试:现有的 pin 盖不住这个形态

serve-no-artifact.e2e.test.ts 已有 4 个 boot,但每一个 fixture 都是 plain object literal(export default { … }),没有一个走 defineStack()。这不是无谓的区别:

• defineStack 会 parse + normalize。同一份 config 经过它之后,每个 object 被盖上 datasource: 'default',每个 field 被补成完整 descriptor。literal fixture 原样进 boot,只有这个 fixture 是「spec 产出的样子」进 boot。
• 这样的 fixture 只能放在真实 node_modules 解析得到的地方:@objectstack/spec 对 config bundler 是 external(BUNDLE_REQUIRE_EXTERNALS),所以它没法像其它三个那样待在 OS tmpdir 里。

第二点正是这个洞能活过修复的原因——不是没人想到,是放不进去。所以新 fixture 落在本包的 gitignored tmp/ 下,和用户工程一样经由真实 node_modules 解析。

这个断言是有承重的

把 fixture 的 manifest.id 改掉之后跑,测试变红,而 server 依然正常起来:

❯ test/serve-no-artifact.e2e.test.ts:207
    expect(stdout, `app plugin missing from the boot banner`).toMatch(/Plugins:[\s\S]*cfgload/)

也就是说它断言的是「app 真的注册并 start 了」,不是「banner 里有字」。

范围说明(写进文件了,避免后人读多)

这一 boot 钉的是这个形态的端到端(config 加载 → app 注册 → 无 dist/ 起服务),不是 fault 1 的机制。单独 revert CLI 侧的 append 已经复现不出崩溃了 —— ADR-0116(#4131)之后 plugin ordering 变成 declared、kernel-enforced 的契约(那个 commit 原话:「kernel.use() registration order proves nothing」,并且点名 AppPlugin/#4085 是标准例子)。两个保证都要,但钉在不同层。

验证

• pnpm vitest run test/serve-no-artifact.e2e.test.ts → 5/5(merge main 后重跑,含 pnpm install --frozen-lockfile + 全量 pnpm build,71/71)
• pnpm exec eslint / pnpm typecheck(@objectstack/cli)→ clean
• node scripts/check-type-check-coverage.mjs → OK(ci(typecheck): 棘轮开始检查测试层 —— 27 个"已覆盖"的包在藏自己的测试 (#4311) #4348 的 test-layer ratchet 也过)

⚠️ 本机跑测时长抖动很大(同一文件 9.5s→478s):是本机另外六个 worktree 在并行跑 suite 造成的资源噪音,不是新测试的成本 —— 已确认无我这边遗留的 serve 进程,机器空闲时新测试单独跑 15.5s。

Closes #3887

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Jul 31, 2026 9:11am

[github-actions]

📓 Docs Drift Check

No hand-written docs reference the 0 changed package(s). ✅