Repository navigation
Commit c6c7830
docs(deployment): the four-doors table spells every runtime publish cell from its rule's runtimeTypes (#30732)
<!-- claude-projects-attribution: {"github_login":"os-elon-musk"} -->
_Requested by **Elon** · [project
thread](https://claude.ai/code/project/chan_01WedDzV26nniwxv7jC88B9D?thread=cmsg_01WedDzV26nniwxv7jC88B9DEqn3QLRg4EXtHXgpTDnYUa)_
domain:devx#1 · os-elon-musk · session_016WV4cxZqEqAW7LNivuEt7c
Fixes #30679
Clause-②: no
Metadata-protocol: none
Skills-docs: updated here
## 维护者速读
- **改了什么**:`validating-metadata.mdx` 的「一道闸、四道门」表格里,运行时发布那一列有 12 格与规则真实的
`runtimeTypes` 不符,全部按规则重写;「Advisory」一行里三条规则在发布门的覆盖不同,拆成三行;图例补上
action、hook、mapping、datasource 四个代码。
- **为什么改**:作者靠这张表判断哪道门会拒收什么;旧格子说某些写入不被检查,实际会被拒(或反之)。
- **风险与回滚**:纯文档,一个文件,无行为改动;回滚即 revert。
- **先看**:① 表格的 `runtime publish` 列(约 L480–L525);②
表下图例段落新增的四个代码与「套件成员」一句。
- **两分钟验证**:对照 `packages/lint/src/authoring-rules.ts` 里任意一条规则的
`runtimeTypes`,看表中对应格子的上标是否按同序拼出。
- **需要你做的**:无,席位落地。
## What changes
One file, `content/docs/deployment/validating-metadata.mdx`, the
four-doors table and its legend. Every row was re-derived on
`origin/main` (`89dbc745`) from `AUTHORING_RULES` in
`packages/lint/src/authoring-rules.ts` (an entry is on the publish door
when `surfaces` is `CLI_AND_RUNTIME`, and then its `runtimeTypes` names
the types) and, for rows whose rules are reference-integrity suite
members, from the member `runtimeTypes` in
`packages/lint/src/reference-integrity-suite.ts` (absent =
`DEFAULT_MEMBER_RUNTIME_TYPES = ['flow']`).
| Row | Was | Now | Rule(s) and `runtimeTypes` |
|:--|:--|:--|:--|
| CEL / predicate validation | `✓ᶠ` | `✓ᶠᵃᶜʰᵒᵛᵖ` |
`validateStackExpressions`: `flow, action, hook, object, view, page` |
| Dataset measure `aggregate` | `—` | `✓ᵈᵗ` |
`validateDatasetMeasureAggregates`: `dataset` |
| Ordering comparands naming a preset | `✓ᵈᵛᵒᵖᶠ` | `✓ᵈᵛᵒᵖᶠʳ` |
`validatePresetComparands`: `dashboard, view, object, page, flow,
report` |
| Empty filter combinators | `✓ᶠ` | `✓ᶠʳ` | `validateEmptyCombinators`:
`flow, report` |
| Object & action name references | `—` | `✓ᶠᵈᵗ` | members
`validateObjectReferences`: `flow, dataset`; `validateActionNameRefs`:
default `flow` |
| Page-component field bindings | `—` | `✓ᶠ` | member
`validatePageFieldBindings`: default `flow` |
| React page block field bindings (§10) | `—` | `✓ᶠ` | member
`validateReactPageProps`: default `flow` |
| Chart bindings outside dashboards | `—` | `✓ᶠʳᵛᵒ` | member
`validateChartBindings`: `flow, report, view, object` |
| Navigation vs. granted access | `—` | `✓ᶠ` | member
`validateNavAccess`: default `flow` |
| `views[]` / page-component / app-nav visibility predicates | `✓ᵛᵖ` |
`✓ᵛᵖᵃ` | `validateVisibilityPredicates`, `validatePredicatePathRefs`:
`view, page, app`; `validatePagePredicateBounds`: `page`. The label now
names the app navigation entry's `visible` (#28663). |
| Advisory row (split) | `—` | `—` | `validateRecordTitle`,
`validateSemanticRoles`, `validateActionLocations`,
`validateSeedReplaySafety`, `validateSeedStateMachine`,
`validateCapabilityReferences`: all `CLI_ONLY` |
| Advisory: form-section layout (new row) | (in the row above, `—`) |
`✓ᵛ` | `validateFormLayout`: `view` |
| Advisory: liveness (new row) | (in the row above, `—`) | `✓ᵉᵐᵈˢ` |
`lintLivenessProperties`: `email_template, mapping, datasource` |
The advisory row is split rather than given one cell, following the
table's own instruction ("if they disagree, split the row by the
collection each id reads").
Legend: four new codes, `✓ᵃᶜ` `action` (two letters because `app` holds
`ᵃ`), `✓ʰ` `hook`, `✓ᵐ` `mapping`, `✓ᵈˢ` `datasource` (two letters
because `dashboard` holds `ᵈ`); the longest-first sentence names `ᵈˢ`
and `ᵃᶜ`. One added sentence says a row of suite members reads the
members' own `runtimeTypes`, and a member that declares none runs on
`flow` writes only, so its cell reads `✓ᶠ`.
Every other row was checked and is unchanged (rule ids and types in the
report on #30679).
## Acceptance notes
- **Default-`flow` members.** Three rows (page-component bindings, react
page block bindings, navigation access) turn from `—` to `✓ᶠ` because
their members declare no `runtimeTypes` and so run on every `flow`
write's snapshot. That snapshot carries no pages or apps, so those
members find nothing there. The cell follows the declared types, as the
legend says and as #30669 did for the list-view and reference-integrity
rows (both carry `ᶠ` for the same default); the new legend sentence says
this so the `✓ᶠ` is not read as "a flow write is judged for page
bindings". If the seat prefers `—` for members that inspect nothing on
their declared type, that is a three-cell revert plus dropping the
sentence.
- **Pair check.** A script parsed every `runtime publish` cell
longest-first against the 17 codes: every cell parses, and no boundary
pair between two codes forms a two-letter code (`ᵖᵒ`, `ᵖᵉ`, `ᵈᵗ`, `ᵈˢ`,
`ᵃᶜ`).
- **Rules with no row (not changed here).** These publish-door rules
have no row in the table: `validateComponentTypes`,
`validatePrintPageBlocks`, `validatePageVariables` (`page`),
`validateFlowApiTriggerSecret`, `lintFlowCredentialLiterals`,
`validateFlowRegionShape` (`flow`), `validateTitleFormatRetired`,
`lintSummaryRollups` (`object`), `validateThankYouRecordFields` (`view,
page`), `lintConnectorCredentialLiterals` (`connector`),
`validateRetiredPermissionResidue` (`permission`),
`validateEmailTemplateHoleGrammar` (`email_template`). That is missing
rows, not stale cells, so it is out of this card's scope and reported to
the seat.
## Verification
`node scripts/pm/dispatch-gates.mjs --commands --repo
objectstack-ai/objectstack` derived 43 commands for this one path (35 by
path, 8 whole-tree). All 43 ran at `915a3541` (after merging
`origin/main` and one whole-tree `turbo run build`, 119/119 tasks) and
every one exited 0. `dispatch-gates.mjs --ran` on that record: exit 0,
"43 derived famil(ies) accounted for — 43 run, 0 NOT-MEASURED". Docs
only, no package files, so `skip-changeset`; nothing to ablate.
<details><summary>43 gates, exit codes at 915a354</summary>
```text
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/check-doc-route-spelling.mjs --advisory :: exit 0
node scripts/check-doc-route-spelling.mjs --self-test :: exit 0
node scripts/check-docs-section-name.mjs :: exit 0
node scripts/check-docs-section-name.mjs --self-test :: exit 0
node scripts/check-section-landing-index.mjs :: exit 0
node scripts/check-section-landing-index.mjs --self-test :: 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 --filter @objectstack/lint run check:doc-security-posture :: exit 0
pnpm --filter @objectstack/spec run check:docs :: exit 0
pnpm --filter @objectstack/spec run check:empty-state :: exit 0
pnpm --filter @objectstack/spec run check:liveness :: exit 0
pnpm --filter @objectstack/spec run check:skill-examples :: exit 0
pnpm --filter @objectstack/spec run check:strictness-ledger :: exit 0
pnpm --filter @objectstack/spec run check:variant-docs :: exit 0
pnpm --filter @objectstack/spec run check:yaml-examples :: exit 0
pnpm check:ci-filter-parity :: exit 0
pnpm check:closed-ceremony-text :: exit 0
pnpm check:corpus-claim-drift :: exit 0
pnpm check:cross-package-test-inputs :: exit 0
pnpm check:doc-anchors :: exit 0
pnpm check:doc-authoring :: exit 0
pnpm check:doc-frontmatter :: exit 0
pnpm check:docs-audit-scope :: exit 0
pnpm check:docs-redirects :: exit 0
pnpm check:docs-single-h1 :: exit 0
pnpm check:docs-spec-enumerations :: exit 0
pnpm check:docs-transcript-drift :: exit 0
pnpm check:driver-memory-census :: exit 0
pnpm check:gitlink-declared :: exit 0
pnpm check:nul-bytes :: exit 0
pnpm check:published-readme-links :: exit 0
pnpm check:react-page-adapter-contract :: exit 0
pnpm check:refd-timer-probe :: exit 0
pnpm check:role-word :: exit 0
pnpm check:skill-identifier-liveness :: exit 0
pnpm check:vendor-version-stamps :: exit 0
pnpm check:watch-hint-literal :: exit 0
```
</details>
---
_Generated by [Claude
Code](https://claude.ai/code/session_016WV4cxZqEqAW7LNivuEt7c)_
Co-authored-by: Claude <noreply@anthropic.com>1 parent 8fed00f commit c6c7830
1 file changed
Lines changed: 22 additions & 14 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
478 | 478 | | |
479 | 479 | | |
480 | 480 | | |
481 | | - | |
| 481 | + | |
482 | 482 | | |
483 | 483 | | |
484 | 484 | | |
485 | 485 | | |
486 | | - | |
| 486 | + | |
487 | 487 | | |
488 | 488 | | |
489 | | - | |
490 | | - | |
491 | | - | |
| 489 | + | |
| 490 | + | |
| 491 | + | |
492 | 492 | | |
493 | 493 | | |
494 | | - | |
495 | | - | |
496 | | - | |
497 | | - | |
| 494 | + | |
| 495 | + | |
| 496 | + | |
| 497 | + | |
498 | 498 | | |
499 | 499 | | |
500 | 500 | | |
| |||
514 | 514 | | |
515 | 515 | | |
516 | 516 | | |
517 | | - | |
518 | | - | |
| 517 | + | |
| 518 | + | |
| 519 | + | |
| 520 | + | |
519 | 521 | | |
520 | 522 | | |
521 | 523 | | |
| |||
526 | 528 | | |
527 | 529 | | |
528 | 530 | | |
529 | | - | |
| 531 | + | |
| 532 | + | |
530 | 533 | | |
531 | | - | |
| 534 | + | |
| 535 | + | |
532 | 536 | | |
533 | | - | |
| 537 | + | |
| 538 | + | |
| 539 | + | |
| 540 | + | |
| 541 | + | |
534 | 542 | | |
535 | 543 | | |
536 | 544 | | |
| |||
0 commit comments