Repository navigation
Commit bb24a53
docs(qa): RUNNER.md wave-3 checklist accuracy slice S8 (#28359)
<!-- claude-projects-attribution: {"github_login":"os-zhuang"} -->
_Requested by **Sam** · [project
thread](https://claude.ai/code/project/chan_01LjZwNRFiG2fkp8SNf6rHNx?thread=cmsg_01LjZwNRFiG2fkp8SNf6rHNxR1z3N3pSCkLgjLSvvp72rM)_
Fixes #28342
Part of #27377
## 维护者速读
- **改了什么**:只改 `docs/qa/platform-checklist/RUNNER.md`
一个文件:三条过时的环境说明按今天的代码改正,另加一条"共享检出要用 `--no-compile` 启动"的环境规则。
- **为什么改**:v18.3.0 第三波测试发现这几处说明和代码对不上,跑测的 agent 会照着错的说明走弯路或误报缺陷。
- **风险与回滚**:纯文档,不动产品代码、不发布;回滚即 revert 本 PR。
- **先看**:`RUNNER.md` 新增的 `--no-compile` 条目;地图条目(#25889 之后改为列表);cookie
条目里新增的 Packaged Automation 页面。
- **两分钟验证**:`node scripts/check-platform-checklist.mjs`,预期打印
`check-platform-checklist: OK`。
- **需要你做的**:无,席位落地。
## What changes
Each row was re-verified against `origin/main` at `488b3ed0` before
editing; all four still held, so none is reported as fixed upstream.
| census row | run record | RUNNER entry | what the code says today |
|---|---|---|---|
| 61 | #27409 | the cookie note ("The cookie is not decorative") | The
Setup app's Packaged Automation page (`automation:packaged`) sends every
request as a bare `fetch` with `credentials: 'include'` and no
`Authorization` header
(`ui/packages/app-shell/src/views/setup/PackagedAutomationPage.tsx`,
`fetchRuntimeStates` / `fetchFlowMetadata` / toggle / clone). A
token-only session renders a load failure ending `HTTP 401` in the
page's alert box. The note now names this page beside storage. |
| 68 | #27409 | the objectui `automated.ref` entry (jsdom unit suite
command) | `pnpm --filter @object-ui/PKG exec vitest run` runs in the
package directory, and `ui/scripts/vitest-invocation-guard.mjs` (called
by `ui/vitest.config.mts`) refuses any run whose Vitest root is not
`ui/`. The entry now gives `cd ui && pnpm exec vitest run --maxWorkers=2
packages/PKG/src/FILE.test.ts` and names the refused form. |
| 198 | #27438 | the map banner entry | Since #25889 a style-load
failure unmounts the map and shows the record list
(`data-testid="map-style-fallback"`): the amber alert banner, a "Try the
map again" button and a "Locations" list built from `filteredMarkers`.
There is no canvas and no marker element
(`ui/packages/plugin-map/src/ObjectMap.tsx`). The entry now describes
the list, gives the current banner wording, names
`OS_CONSOLE_MAP_STYLE_URL` as the deployment's style rung, and says what
to score. |
| added (comment 6539852711) | #27481 | new environment fact: boot with
`--no-compile` on a shared checkout | A default `os dev` compiles
`objectstack.config.ts` into `CWD/dist/objectstack.json` before it
starts (`devCompilesAtBoot()` in
`packages/cli/src/utils/dev-compile-at-boot.ts`), and its watch loop
recompiles into the same file (`startWatchRecompile()` in
`packages/cli/src/commands/dev.ts`). The path resolves against the
working directory, not `OS_HOME`, so `--fresh` does not isolate it. One
rule covers every item whose `fixtures.requires` carries `pnpm dev --
--fresh -p PORT --seed-admin`. As the card says, none of the 37 items is
edited. |
Each edit makes a clause more precise, and none is weakened. The
`--no-compile` rule keeps the caveats the code imposes: a missing
artifact is still compiled, a stale artifact draws a warning, and
`--no-compile` does not stop the watch loop, so the rule also adds
`--no-watch` for trees where someone may be editing sources.
## Tests
Docs only. No test applies, and no ablation is owed because no tested
behaviour changed.
## Acceptance notes
- Edit shape: `RUNNER.md` carries no `revision` / `history` (those exist
only on the area-file items), so the card's "revision +1, one history
row" shape has nothing to apply to here. The run records are cited
inline in each entry instead.
- Changeset: none. This is a docs-only change under `docs/qa/` and
nothing in it is published. Label `skip-changeset`.
- No product defect was found on reading. All four findings were stale
text.
## Verification
All gates below ran at head `a18d8106`, with each exit code captured
before any pipe.
<details><summary>dispatch-gates --commands (16 derived) and the --ran
reconciliation</summary>
```
node scripts/check-adr-links.mjs :: exit 0
node scripts/check-adr-links.mjs --self-test :: exit 0
node scripts/check-closing-keyword-parity.mjs :: exit 0
node scripts/check-closing-keyword-parity.mjs --self-test :: exit 0
node scripts/check-comment-mask-corpus.mjs :: exit 0
node scripts/ci/plan-test-core-shards.mjs --self-test :: exit 0
pnpm --filter @objectstack/lint run check:doc-formula-expressions :: exit 0
pnpm check:ci-filter-parity :: exit 0
pnpm check:cross-package-test-inputs :: exit 0
pnpm check:doc-authoring :: exit 0
pnpm check:driver-memory-census :: exit 0
pnpm check:gitlink-declared :: exit 0
pnpm check:nul-bytes :: exit 0
pnpm check:platform-checklist :: exit 0
pnpm check:refd-timer-probe :: exit 0
pnpm check:watch-hint-literal :: exit 0
✓ dispatch-gates --ran: 16 derived famil(ies) accounted for — 16 run, 0 NOT-MEASURED (a DERIVED zero — all 16 recorded an exit code and none of them is 3).
```
`check:platform-checklist`: `check-platform-checklist: OK — 16 areas,
352 items (347 active, 1 planned) …`. The first attempt at
`check:doc-formula-expressions` exited 3 (PREREQUISITE NOT MET:
`@objectstack/formula` and `@objectstack/lint` were not built). After
the build that the gate prescribes, it exited 0, and the exit 0 is the
value recorded above.
</details>
---
_Generated by [Claude
Code](https://claude.ai/code/session_01QUs3BrXjSo6hk7EnLdjcja)_
Co-authored-by: Claude <noreply@anthropic.com>1 parent 2db3281 commit bb24a53
1 file changed
Lines changed: 50 additions & 12 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
384 | 384 | | |
385 | 385 | | |
386 | 386 | | |
| 387 | + | |
| 388 | + | |
| 389 | + | |
| 390 | + | |
| 391 | + | |
| 392 | + | |
| 393 | + | |
| 394 | + | |
| 395 | + | |
| 396 | + | |
| 397 | + | |
| 398 | + | |
| 399 | + | |
| 400 | + | |
| 401 | + | |
| 402 | + | |
| 403 | + | |
| 404 | + | |
| 405 | + | |
| 406 | + | |
| 407 | + | |
387 | 408 | | |
388 | 409 | | |
389 | 410 | | |
| |||
439 | 460 | | |
440 | 461 | | |
441 | 462 | | |
442 | | - | |
| 463 | + | |
| 464 | + | |
| 465 | + | |
| 466 | + | |
| 467 | + | |
| 468 | + | |
| 469 | + | |
| 470 | + | |
| 471 | + | |
443 | 472 | | |
444 | 473 | | |
445 | 474 | | |
| |||
556 | 585 | | |
557 | 586 | | |
558 | 587 | | |
559 | | - | |
560 | | - | |
| 588 | + | |
| 589 | + | |
| 590 | + | |
| 591 | + | |
| 592 | + | |
| 593 | + | |
561 | 594 | | |
562 | 595 | | |
563 | 596 | | |
| |||
725 | 758 | | |
726 | 759 | | |
727 | 760 | | |
728 | | - | |
729 | | - | |
| 761 | + | |
| 762 | + | |
730 | 763 | | |
731 | | - | |
732 | | - | |
| 764 | + | |
| 765 | + | |
733 | 766 | | |
734 | 767 | | |
735 | | - | |
736 | | - | |
737 | | - | |
738 | | - | |
739 | | - | |
| 768 | + | |
| 769 | + | |
| 770 | + | |
| 771 | + | |
| 772 | + | |
| 773 | + | |
| 774 | + | |
| 775 | + | |
| 776 | + | |
| 777 | + | |
740 | 778 | | |
741 | 779 | | |
742 | 780 | | |
| |||
0 commit comments