Repository navigation
Commit f7c95cd
test(dogfood): pin five api-backend checklist items at the HTTP layer (#26787)
<!-- claude-projects-attribution: {"github_login":"os-warren"} -->
_Requested by **Warren** · [project
thread](https://claude.ai/code/project/chan_01U5RdnAAmkSQmZbqh6FtqZ8?thread=cmsg_01U5RdnAAmkSQmZbqh6FtqZ8VsCYkn9rw8Z1i5vq5MHxL4)_
Refs #26572 (slice 1 of about 3: items declarative-endpoint-execution,
second-object-exposure-and-internal-fields,
data-request-shape-and-query-arity, meta-read-doors-v18,
error-sentences-and-unique-violation-wire-code)
Clause-②: no
Metadata-protocol: none
## 维护者速读
- 改了什么:给 api-backend 清单里 5 个被 18.2.0 Tier 1 扫描判为 PARTIAL 的条目补上 HTTP 层(真实
Hono 栈)的 dogfood 钉子,并把这 5 条的 automated.ref、verify 文本、revision 和 history
更新。
- 为什么改:这些条款的判据在 HTTP 或构建层,旧钉子只到单元/引擎层,每次发版扫描都要人工再跑活腿;现在变成常驻、可重跑的证明。
- 风险与回滚:只加测试和清单文本,不改任何产品代码;回滚就是 revert 本 PR。dogfood 只在 main 的定时/推送批次跑,不进
PR 和合并队列。
-
先看:`packages/qa/dogfood/test/declarative-endpoint-authoring-refusal.dogfood.test.ts`(子进程跑
CLI)、`packages/qa/dogfood/test/fixtures/second-object-exposure-fixture.ts`(共享
fixture 加了一个 internal
字段)、`docs/qa/platform-checklist/areas/api-backend.json`。
- 两分钟验证:`pnpm --filter @objectstack/dogfood exec vitest run
--maxWorkers=2 test/data-request-shape-live.dogfood.test.ts`,预期 13
个用例全绿。
- 需要你做的:无,席位落地。
## What changes
Five api-backend checklist items that the release-18.2.0 Tier 1 sweep
(#26468) scored PARTIAL now carry pins at the layer their oracle names.
Every new case drives a booted stack through `@objectstack/verify`'s
real HTTP surface (Hono request injection), or the CLI's own
`bin/run.js` as a child process for the one `build` oracle.
| Item | Clauses pinned | Pin |
|---|---|---|
| `api-backend.declarative-endpoint-execution` | acceptance[1] (401
`UNAUTHENTICATED` code), acceptance[2] (`os validate` / `os build`
refuse a script and a proxy endpoint, naming it, the type and the flow
prescription, no artifact; the #5488 withdrawal: `PUT /meta/api/NAME`
answers 403 `NOT_CREATABLE`) |
`showcase-declarative-endpoints.dogfood.test.ts` (extended),
`declarative-endpoint-authoring-refusal.dogfood.test.ts` (new) |
| `api-backend.second-object-exposure-and-internal-fields` |
acceptance[1] (refusal located at `filter.REL` on both doors),
acceptance[3] (an `internal: true` field refused 400 `INVALID_FIELD`
naming object and field in filter, sort, groupBy and aggregate
positions) | `second-object-exposure.dogfood.test.ts` (extended); its
fixture gains `sox_source.internal_f` |
| `api-backend.data-request-shape-and-query-arity` | acceptance[1]–[4] |
`data-request-shape-live.dogfood.test.ts` (new) |
| `api-backend.meta-read-doors-v18` | acceptance[1]–[4] (the FLS half
for a `client_liaison`-bound member, both halves agreeing) |
`meta-read-doors-live.dogfood.test.ts` (new) |
| `api-backend.error-sentences-and-unique-violation-wire-code` |
acceptance[1]–[3] | `error-sentences-live.dogfood.test.ts` +
`fixtures/error-sentences-fixture.ts` (new scratch app) |
Each item's `automated.ref` names the new pins and what they assert, the
verify texts that said "live leg" now say which pin carries the clause,
`revision` is bumped and a `history` row cites #26572. No clause text
changed. No product code changed.
## Why
The card's ruled scope (triage 6437722483): pin the 11 api-backend Tier
1 clauses the 18.2.0 sweep scored PARTIAL at the layer their oracle
names, in `packages/qa/dogfood/**`, with the checklist item revisions
bumped, in slices of about five items, with no new CI lane. This is the
first slice. The other six items (packaged-action-disabled-dispatch,
action-activation-door-contract, rest-crud-config-contract,
rest-batch-config-contract, rest-metadata-config-contract,
rest-route-generation-tombstones) are left for later slices.
## Tests
All seven touched dogfood files on the final head 19a4d70, under the
verify lock, after rebuilding the one package main moved since the base
(`driver-sql`):
```
pnpm --filter @objectstack/dogfood exec vitest run --maxWorkers=2 test/data-request-shape-live.dogfood.test.ts test/meta-read-doors-live.dogfood.test.ts test/error-sentences-live.dogfood.test.ts test/declarative-endpoint-authoring-refusal.dogfood.test.ts test/second-object-exposure.dogfood.test.ts test/import-reference-exposure.dogfood.test.ts test/showcase-declarative-endpoints.dogfood.test.ts
Test Files 7 passed (7)
Tests 119 passed (119)
os-verify-lock: VERDICT command-exit 0
```
`import-reference-exposure.dogfood.test.ts` is in the run because it
shares the fixture that gained a field. Every expectation was first
measured against the live answer on a probe boot and checked against the
clause text before it was written down. No ablation: the diff changes no
tested behaviour, only adds pins over behaviour that already holds.
## Acceptance notes
- Dogfood runs only in `main`'s scheduled and push battery (`Dogfood
Regression Gate`'s `if:` excludes `pull_request` and `merge_group`), so
the PR's CI does not run these files; the local run above is their
evidence until the next `main` battery.
- The CLI pin writes its scratch config through `defineStack(…, {
strict: false })` with `@objectstack/spec` linked into a temporary
`node_modules`: the commands accept only a stack `defineStack` returned,
and the strict factory would refuse the endpoint at import, before the
command's own gate.
- The located position of a nested-relation refusal lives only in the
refusal sentence (`… at 'filter.REL' …`); the pin asserts that token,
the code, the status and `object`.
- The storage fault is forced by putting the local adapter's root under
a regular file, so the write fails with `ENOTDIR`; the pin asserts `500
INTERNAL` and that neither the errno, the path nor a stack line reaches
the body.
## Verification
<details><summary>Gates (dispatch-gates --commands, reconciled with
--ran)</summary>
- `node scripts/check-platform-checklist.mjs`: exit 0, `OK — 16 areas,
329 items (324 active, 1 planned)`.
- 55 derived commands: 53 exit 0; 2 exit 3 (prerequisite not met,
nothing measured): `node scripts/check-plugin-teardown-shape.mjs
--self-test` (its positive control is pinned to a commit outside this
shallow clone) and `pnpm check:dual-build-cjs-loads` (reads built output
of packages outside the dogfood closure). Both run in CI's `Lint & Repo
Gates`.
- `pnpm --filter @objectstack/dogfood run typecheck`: exit 0.
- eslint over the eight touched TypeScript files: exit 0.
- `dispatch-gates --ran`: 55 derived families accounted for, 53 run, 2
NOT-MEASURED, 0 unrun.
</details>
No changeset: `@objectstack/dogfood` is private and `docs/qa/**` ships
in no package, so this PR carries `skip-changeset`.
## Human Minimum
- [x] 1. Schemas start as Zod; `packages/spec` holds no runtime logic.
(not touched)
- [x] 2. Every name I added uses the casing for its kind.
- [x] 3. No formatter ran; `pnpm lint` passes. (eslint over the touched
files)
- [x] 4. One issue, one branch off an up-to-date `main`, one pull
request.
- [x] 5. A change that publishes carries a changeset. (nothing
publishes)
- [x] 6. `packages/spec` touched: n/a.
- [x] 7. No hand edits to `content/docs/references/`,
`packages/*/CHANGELOG.md` or `content/docs/releases/`.
- [x] 8. Title, body and comments are in English.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
https://claude.ai/code/session_01JQwxbWUpGqdpDRiD79LqXV
---
_Generated by [Claude
Code](https://claude.ai/code/session_01JQwxbWUpGqdpDRiD79LqXV)_
---------
Co-authored-by: Claude <noreply@anthropic.com>1 parent 83c4bd2 commit f7c95cd
9 files changed
Lines changed: 845 additions & 23 deletions
File tree
- docs/qa/platform-checklist/areas
- packages/qa/dogfood/test
- fixtures
Large diffs are not rendered by default.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
| 170 | + | |
| 171 | + | |
| 172 | + | |
| 173 | + | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
| 181 | + | |
| 182 | + | |
| 183 | + | |
| 184 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
| 170 | + | |
| 171 | + | |
0 commit comments