Repository navigation
Commit 9b85162
docs(skills): the objectui data-integration guide stops teaching the MSW plugin removed in 12.0 (#27764)
<!-- claude-projects-attribution: {"github_login":"os-elon-musk"} -->
_Requested by **Elon** · [project
thread](https://claude.ai/code/project/chan_01WedDzV26nniwxv7jC88B9D?thread=cmsg_01WedDzV26nniwxv7jC88B9DEgy1aicRXWh4AbhmimiUdx)_
Fixes #27678
Clause-②: no
Metadata-protocol: none
## 维护者速读
- 改了什么:已发布的 `objectui` 技能不再教 12.0 已删除的 MSW
插件;数据集成指南的「前端先行开发」一节改教树上真有的两条路(无后端用静态 scope,或本地 `os dev` 起真服务 + Vite 代理
`/api`),对应 eval 改判这个答案;顺手删掉 console 里没人读的 `VITE_USE_MOCK_SERVER` 等 MSW
残留。
- 为什么改:客户 agent 加载技能后照抄会去装 11.0.0 的旧插件(npm 上未弃用、能装上),装进 18.x 栈;eval
还给这个错答案打满分。
- 风险与回滚:纯文档、eval 与 console 构建配置,无运行时行为变化;回滚即 revert 本 PR。技能净减 35 行、约 171
token。
- 先看:`skills/objectui/guides/data-integration.md`(新「Frontend-first
development」一节的每条事实)、`skills/objectui/evals/data-integration.json`(eval
2)、`ui/apps/console/vercel.json`(rewrite 正则少了 `mockServiceWorker.js`
排除项)。
- 两分钟验证:`git grep -n 'plugin-msw\|MSWPlugin' -- skills; git grep -n
'VITE_USE_MOCK_SERVER\|vendor-msw' -- ui/apps` 两条都无输出;`node
ui/scripts/check-skill-eval-tokens.mjs` 退出 0。
- 需要你做的:受管面(`skills/**`),席位契约复核通过后请批准;npm 上是否弃用
`@objectstack/plugin-msw` 是发版动作,另由你定。
## What changes
- `skills/objectui/guides/data-integration.md`: the section "MSW mock
setup (frontend-first development)" (a browser kernel built on the MSW
plugin package, removed in 12.0 by `7087cfe6e3`) becomes "Frontend-first
development". It names the two paths the tree supports today:
- no backend: the existing "Static data (no backend)" scope;
- a real API locally: `os dev` from the ObjectStack app, with the Vite
dev server proxying `/api` to `http://localhost:3000` so page and API
share one origin (the same shape `ui/apps/console/vite.config.ts` uses).
It also states what `os dev` does with data: it persists to a SQLite
file, `--fresh` gives a throwaway database, a dev admin is seeded on an
empty database, the retired in-memory driver is refused, and `--database
:memory:` is SQLite's in-memory database. The two MSW pitfall bullets
are removed.
- `skills/objectui/evals/data-integration.json`, eval 2: the prompt asks
for a working local API before the backend is deployed. `must_contain`
is `os dev`, `proxy`, `objectstack.config`; `must_not_contain` is
`enableBrowser` and `setupWorker` (the MSW plugin option and the MSW
worker API).
- Console remnants (cross-domain exception granted by triage
6504442774):
- `VITE_USE_MOCK_SERVER=false` leaves
`ui/apps/console/.env.development`, `.env.production` and the Vercel
`buildCommand`. No source reads the key: `git grep VITE_USE_MOCK_SERVER
-- ui` outside these files, the test below and the CHANGELOG finds one
comment in `ui/playwright.import-console.config.ts`.
- The Vercel rewrite stops excluding `mockServiceWorker.js`;
`ui/apps/console/public` holds no such file.
- The `vendor-msw` row leaves the chunk table in
`ui/apps/console/docs/deployment.md`; `vite.config.ts` declares no such
chunk.
-
`ui/packages/app-shell/src/observability/committed-telemetry-endpoint.test.ts`,
measured first as the card asked:
- `:118` is a vacuum guard that the parser reads real assignments out of
`.env.production`. It used `VITE_USE_MOCK_SERVER` only as a known line,
not as live behaviour. It now asserts `VITE_SERVER_URL` parses to the
empty string.
- `:136` is a synthetic negative probe that reads no file; its second
line becomes `VITE_BASE_PATH=/`.
- Changeset `27678-objectui-skill-msw-removed.md`: `@objectstack/skills`
and `@object-ui/console` patch.
### Published-skills readings
| reading | before | after |
|---|---|---|
| `skills/objectui/guides/data-integration.md` lines / ratchet tokens |
514 / 4451 | 479 / 4280 (ceiling 4451, headroom 171) |
| `skills/objectui/evals/data-integration.json` lines / ratchet tokens |
54 / 471 | 54 / 466 (ceiling 471, headroom 5) |
| `skills/objectui/**` lines | 5446 | 5411 |
| all `skills/**/SKILL.md` lines | 4610 | 4610 |
Ceilings are left where they are; the shrink shows as headroom.
## Tests
- `pnpm exec vitest run
packages/app-shell/src/observability/committed-telemetry-endpoint.test.ts`
(from `ui/`): Test Files 1 passed, Tests 5 passed.
- `node ui/scripts/check-skill-eval-tokens.mjs`: exit 0, "Every
must_contain token is taught by its own skill bundle."
- `node ui/scripts/check-skills-paths.mjs`: exit 0 (85/86 stated paths
resolve, 1 baselined, unchanged).
## Acceptance notes
- `git grep -n 'plugin-msw\|MSWPlugin' -- skills`: 0 hits.
- `git grep -n 'VITE_USE_MOCK_SERVER\|vendor-msw' -- ui/apps`: 0 hits.
- Survivors outside `ui/apps`, out of scope: `ui/CHANGELOG.md:392`
(history, not edited) and a comment in
`ui/playwright.import-console.config.ts:24` that sets the variable in a
recipe.
- The dispatch's mechanism assumption ("`objectstack dev` with an
in-memory driver") did not hold on `origin/main`: the in-memory engine
is no longer a boot store (`packages/cli/src/commands/dev.ts` header;
`dev-default-db.test.ts` pins the refusal). The guide teaches what the
tree does instead.
- `npm view @objectstack/plugin-msw version deprecated` on 2026-10-29:
`11.0.0`, not deprecated. Deprecating it is the maintainer's release
action and is not part of this PR.
## Verification
<details><summary>dispatch-gates: 57 derived families, all exit 0, at
a5cbb8f</summary>
`node scripts/pm/dispatch-gates.mjs --ran`: "57 derived famil(ies)
accounted for — 57 run, 0 NOT-MEASURED". The first pass recorded exit 1
on `pnpm --dir ui exec vitest run scripts/` (unbuilt `@objectstack/spec`
dist) and on two gates that read the generated
`packages/spec/src/migrations/registry.ts` before it existed, plus exit
3 on six build-prerequisite gates. After `turbo run build
--filter='@objectstack/client-react...' --filter=@objectstack/lint...`,
every one of them re-ran at exit 0. The pre-push checks
`check-regen-pending` and `check-commit-card-trailers --range
origin/main..HEAD` both exit 0.
</details>
🤖 Generated with [Claude Code](https://claude.com/claude-code)
https://claude.ai/code/session_016WV4cymVzRLDH1j6gwgGAk
---
_Generated by [Claude
Code](https://claude.ai/code/session_016WV4cymVzRLDH1j6gwgGAk)_
---------
Co-authored-by: Claude <noreply@anthropic.com>1 parent 3865159 commit 9b85162
8 files changed
Lines changed: 42 additions & 66 deletions
File tree
- .changeset
- skills/objectui
- evals
- guides
- ui
- apps/console
- docs
- packages/app-shell/src/observability
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
21 | 21 | | |
22 | 22 | | |
23 | 23 | | |
24 | | - | |
25 | | - | |
| 24 | + | |
| 25 | + | |
26 | 26 | | |
27 | 27 | | |
28 | 28 | | |
29 | | - | |
30 | | - | |
31 | | - | |
| 29 | + | |
| 30 | + | |
32 | 31 | | |
33 | 32 | | |
34 | 33 | | |
35 | | - | |
| 34 | + | |
| 35 | + | |
36 | 36 | | |
37 | 37 | | |
38 | 38 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
351 | 351 | | |
352 | 352 | | |
353 | 353 | | |
354 | | - | |
| 354 | + | |
355 | 355 | | |
356 | | - | |
| 356 | + | |
| 357 | + | |
357 | 358 | | |
358 | | - | |
| 359 | + | |
| 360 | + | |
| 361 | + | |
| 362 | + | |
359 | 363 | | |
360 | | - | |
361 | | - | |
362 | | - | |
363 | | - | |
364 | | - | |
365 | | - | |
366 | | - | |
367 | | - | |
368 | | - | |
369 | | - | |
370 | | - | |
371 | | - | |
372 | | - | |
373 | | - | |
374 | | - | |
375 | | - | |
376 | | - | |
377 | | - | |
378 | | - | |
379 | | - | |
380 | | - | |
381 | | - | |
382 | | - | |
383 | | - | |
384 | | - | |
385 | | - | |
386 | | - | |
387 | | - | |
388 | | - | |
389 | | - | |
390 | | - | |
391 | | - | |
| 364 | + | |
| 365 | + | |
| 366 | + | |
392 | 367 | | |
393 | 368 | | |
394 | | - | |
395 | | - | |
396 | 369 | | |
397 | | - | |
398 | | - | |
399 | | - | |
400 | | - | |
401 | | - | |
402 | | - | |
403 | | - | |
404 | | - | |
405 | | - | |
406 | | - | |
407 | | - | |
408 | | - | |
409 | | - | |
410 | | - | |
| 370 | + | |
| 371 | + | |
| 372 | + | |
| 373 | + | |
411 | 374 | | |
412 | 375 | | |
| 376 | + | |
| 377 | + | |
| 378 | + | |
| 379 | + | |
| 380 | + | |
413 | 381 | | |
414 | 382 | | |
415 | 383 | | |
| |||
507 | 475 | | |
508 | 476 | | |
509 | 477 | | |
510 | | - | |
511 | | - | |
512 | 478 | | |
513 | 479 | | |
514 | 480 | | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
17 | 17 | | |
18 | 18 | | |
19 | 19 | | |
20 | | - | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
8 | | - | |
9 | 8 | | |
10 | 9 | | |
11 | 10 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
125 | 125 | | |
126 | 126 | | |
127 | 127 | | |
128 | | - | |
129 | 128 | | |
130 | 129 | | |
131 | 130 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
4 | | - | |
| 4 | + | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
8 | | - | |
| 8 | + | |
9 | 9 | | |
10 | 10 | | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
115 | 115 | | |
116 | 116 | | |
117 | 117 | | |
118 | | - | |
| 118 | + | |
119 | 119 | | |
120 | 120 | | |
121 | 121 | | |
| |||
133 | 133 | | |
134 | 134 | | |
135 | 135 | | |
136 | | - | |
| 136 | + | |
137 | 137 | | |
138 | 138 | | |
139 | 139 | | |
| |||
0 commit comments