Skip to content

Commit c6c7830

Browse files
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

File tree

‎content/docs/deployment/validating-metadata.mdx‎

Lines changed: 22 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -478,23 +478,23 @@ orthogonal to both, and no cell here can carry it; it is written out in
478478
| | `os validate` | `os build` | `os lint` | runtime publish |
479479
|---|---|---|---|---|
480480
| Protocol schema (Zod) | ✓ | ✓ | — | ✓ |
481-
| CEL / predicate validation (ADR-0032) | ✓ | ✓ | ✓ | ✓ᶠ |
481+
| CEL / predicate validation (ADR-0032) | ✓ | ✓ | ✓ | ✓ᶠᵃᶜʰᵒᵛᵖ |
482482
| List-view navigation modes (ADR-0053) | ✓ | ✓ | ✓ | — |
483483
| Zod-valid but functionally inert declarations — a `summary` with no operations (ADR-0078), a managed object advertising an API method its affordances refuse (#7521) | ✓ | ✓ | ✓ | ✓ᵒ |
484484
| View container shape | ✓ | ✓ | ✓ | — |
485485
| Widget-binding integrity (ADR-0021) | ✓ | ✓ | ✓ | ✓ᵈ |
486-
| Dataset measure `aggregate` × the field's declared type — a pair the spec's compatibility table refuses, e.g. `avg` over a `datetime` field (#16354) | ✓ | ✓ | ✓ | — |
486+
| Dataset measure `aggregate` × the field's declared type — a pair the spec's compatibility table refuses, e.g. `avg` over a `datetime` field (#16354) | ✓ | ✓ | ✓ | ✓ᵈᵗ |
487487
| Dashboard action/route references (ADR-0049) | ✓ | ✓ | ✓ | — |
488488
| Filter placeholder resolvability (#3574) | ✓ | ✓ | ✓ | — |
489-
| Ordering comparands naming a date-range preset — `last_30_days` in a `>=` position (#8793) | ✓ | ✓ | ✓ | ✓ᵈᵛᵒᵖᶠ |
490-
| Empty filter combinators — `$and: []`, `$or: []`, `$not: {}` (#5330) | ✓ | ✓ | ✓ | ✓ᶠ |
491-
| Object & action name references (#3583) | ✓ | ✓ | ✓ | — |
489+
| Ordering comparands naming a date-range preset — `last_30_days` in a `>=` position (#8793) | ✓ | ✓ | ✓ | ✓ᵈᵛᵒᵖᶠʳ |
490+
| Empty filter combinators — `$and: []`, `$or: []`, `$not: {}` (#5330) | ✓ | ✓ | ✓ | ✓ᶠʳ |
491+
| Object & action name references (#3583) | ✓ | ✓ | ✓ | ✓ᶠᵈᵗ |
492492
| Reference integrity — flow node writes, template paths, read-only writes (#3583); at the publish door each write type runs only the members that declare it, and the flow members run on `flow` alone (#9313) | ✓ | ✓ | ✓ | ✓ᶠᵛᵒᵈᵗʳᵖ |
493493
| List-view field members — a list view's `sort` (a `sortable: false` field, a `formula`, an unknown name: `sort-field-unsortable`), its `searchableFields` (`searchable-field-unknown`) and its field references, columns, filter keys, grouping and the board bindings (`list-view-field-unknown`); the row merges three members, so its codes follow no one rule's order, and the `page` door runs the sort member only (#9313, #15495, #30095) | ✓ | ✓ | ✓ | ✓ᶠᵛᵒᵖ |
494-
| Page-component field bindings (#3583) | ✓ | ✓ | ✓ | — |
495-
| React page block field bindings — §10 (#4340) | ✓ | ✓ | ✓ | — |
496-
| Chart bindings outside dashboards (#3583) | ✓ | ✓ | ✓ | — |
497-
| Navigation vs. granted access (ADR-0090 D6) | ✓ | ✓ | ✓ | — |
494+
| Page-component field bindings (#3583) | ✓ | ✓ | ✓ | ✓ᶠ |
495+
| React page block field bindings — §10 (#4340) | ✓ | ✓ | ✓ | ✓ᶠ |
496+
| Chart bindings outside dashboards (#3583) | ✓ | ✓ | ✓ | ✓ᶠʳᵛᵒ |
497+
| Navigation vs. granted access (ADR-0090 D6) | ✓ | ✓ | ✓ | ✓ᶠ |
498498
| SDUI scoped styling (ADR-0065) | ✓ | ✓ | ✓ | — |
499499
| SDUI component props — every `ComponentPropsMap` verdict: an undeclared prop, a value its props schema rejects, a missing `dataSource.object` binding, and a retired prop (`retiredKey()`) refused with its prescription (#23026, #23147; at the save door #23388) | ✓ | ✓ | ✓ | ✓ᵖ |
500500
| JSX / React page source parses (ADR-0080/0081) | ✓ | ✓ | ✓ | — |
@@ -514,8 +514,10 @@ orthogonal to both, and no cell here can carry it; it is written out in
514514
| View references — form targets, view-key collisions (#2554) | ✓ | ✓ | ✓ | — |
515515
| Flow authoring anti-patterns (#1874) | ✓ | ✓ | ✓ | ✓ᶠ |
516516
| Flow trigger readiness — a flow that looks armed and never launches (#5762) | ✓ | ✓ | ✓ | ✓ᶠ |
517-
| `views[]` and page-component conditional-visibility predicates — CEL syntax, parse budget, bare identifiers, binding-root layer; schema path refs on `views[]` only (ADR-0089 D3b, #7010; page components at the save door #24491) | ✓ | ✓ | ✓ | ✓ᵛᵖ |
518-
| Advisory: record titles, semantic field pointers (ADR-0085), form-section layout, action placement, seed replay/state safety, capability references, liveness | ✓ | ✓ | ✓ | — |
517+
| `views[]` and page-component conditional-visibility predicates — CEL syntax, parse budget, bare identifiers, binding-root layer; schema path refs on `views[]` only (ADR-0089 D3b, #7010; page components at the save door #24491); an app navigation entry's `visible` at the save door (#28663) | ✓ | ✓ | ✓ | ✓ᵛᵖᵃ |
518+
| Advisory: record titles, semantic field pointers (ADR-0085), action placement, seed replay/state safety, capability references | ✓ | ✓ | ✓ | — |
519+
| Advisory: form-section layout | ✓ | ✓ | ✓ | ✓ᵛ |
520+
| Advisory: liveness | ✓ | ✓ | ✓ | ✓ᵉᵐᵈˢ |
519521
| Package docs — flatness, prefixes, links (ADR-0046) | ✓ | ✓ | ✓ | — |
520522
| Undeclared authoring keys — every metadata collection (#3786) and the stack's own top-level keys (#4167) | ✓ | ✓ | — | — |
521523
| Collection item owner stamps — an item whose body `_packageId` names a package other than the one that ships it: the stack's `manifest.id` (none without a `manifest`); in a `packages[]` artifact each body's own `id`, and `manifest.id` for a top-level item no body declares, except seed `data`, `datasets` and `jobs`, which the boot never files from the top level. The boot and the install refuse the same stamp when they register the item (ADR-0010, ADR-0130 D4) | ✓ | ✓ | — | — |
@@ -526,11 +528,17 @@ orthogonal to both, and no cell here can carry it; it is written out in
526528
**Every superscript in the `runtime publish` column is one metadata type whose
527529
writes that rule inspects: `✓ᶠ` `flow`, `✓ᵛ` `view`, `✓ᵈ` `dashboard`, `✓ᵒ`
528530
`object`, `✓ᵖ` `page`, `✓ˢ` `seed`, `✓ᵇ` `book`, `✓ᵖᵉ` `permission`,
529-
`✓ᵖᵒ` `position`, `✓ᵃ` `app`, `✓ᵉ` `email_template`, `✓ᵈᵗ` `dataset`, `✓ʳ` `report`** — the two
531+
`✓ᵖᵒ` `position`, `✓ᵃ` `app`, `✓ᵉ` `email_template`, `✓ᵈᵗ` `dataset`, `✓ʳ` `report`,
532+
`✓ᵃᶜ` `action`, `✓ʰ` `hook`, `✓ᵐ` `mapping`, `✓ᵈˢ` `datasource`** — the two
530533
`ᵖ`-initial pairs carry a second letter because `page` already holds `ᵖ` on its
531-
own, and `dataset` carries `ᵈᵗ` because `dashboard` holds `ᵈ`. Read the codes **longest-first**: `ᵖᵒ` is `position`, never `page`
534+
own, `dataset` and `datasource` carry `ᵈᵗ` and `ᵈˢ` because `dashboard` holds `ᵈ`,
535+
and `action` carries `ᵃᶜ` because `app` holds `ᵃ`. Read the codes **longest-first**: `ᵖᵒ` is `position`, never `page`
532536
followed by `object`, `ᵖᵉ` is `permission`, never `page` followed by
533-
`email_template`, and `ᵈᵗ` is `dataset`. A cell lists one superscript per declared type, in the order the rule declares them, and that
537+
`email_template`, `ᵈᵗ` is `dataset`, `ᵈˢ` is `datasource` and `ᵃᶜ` is `action`.
538+
A row whose rules are members of the reference-integrity suite reads the
539+
members' own `runtimeTypes` in `packages/lint/src/reference-integrity-suite.ts`,
540+
and a member that declares none runs on `flow` writes only (the suite's frozen
541+
default), so its cell reads `✓ᶠ`. A cell lists one superscript per declared type, in the order the rule declares them, and that
534542
rule's own `runtimeTypes` in `AUTHORING_RULES` is the authority — the set has
535543
grown a type at a time (#4463 shipped P1 as `flow` and four rule families, #7220
536544
moved the whole `views[]` visibility-predicate family across in one edit, #7529

0 commit comments

Comments
 (0)