@cosmicdrift/kumiko-framework 0.405.0 → 0.409.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (214) hide show
  1. package/agents/api/framework-db.md +1 -0
  2. package/agents/api/framework-engine.md +18 -2
  3. package/agents/api/framework-ui-types.md +15 -0
  4. package/agents/api/renderer-web.md +156 -2
  5. package/agents/api/types.md +113 -71
  6. package/agents/api.md +4 -4
  7. package/agents/boot-rules.md +743 -0
  8. package/agents/examples/contact.md +167 -0
  9. package/agents/examples/delivery-notifications.md +34 -1
  10. package/agents/examples/lane-routing.md +13 -0
  11. package/agents/examples/record-detail-layout.md +13 -2
  12. package/agents/examples/search.md +65 -3
  13. package/agents/examples/secrets-demo.md +96 -2
  14. package/agents/examples/tenant-inactivity.md +138 -0
  15. package/agents/examples.md +2 -0
  16. package/agents/features-index.md +4 -0
  17. package/agents/features.md +24 -1
  18. package/agents/widgets.md +12 -1
  19. package/dist/api/export/export-rows.js +1 -0
  20. package/dist/compliance/index.d.ts +1 -1
  21. package/dist/db/event-store-executor-read-where.js +15 -5
  22. package/dist/db/index.d.ts +1 -1
  23. package/dist/db/index.js +1 -1
  24. package/dist/db/migrate-generator.js +3 -1
  25. package/dist/db/queries/event-consumer.js +11 -7
  26. package/dist/db/queries/event-store.d.ts +2 -1
  27. package/dist/db/queries/event-store.js +25 -6
  28. package/dist/db/queries/rls-boot-catalog.js +3 -1
  29. package/dist/db/queries/session-advisory-lock.d.ts +7 -0
  30. package/dist/db/queries/session-advisory-lock.js +23 -0
  31. package/dist/db/query.js +7 -10
  32. package/dist/db/row-level-security-connection.js +4 -2
  33. package/dist/engine/active-membership.js +1 -0
  34. package/dist/engine/boot-validator/access-declarations.js +57 -33
  35. package/dist/engine/boot-validator/action-wiring.js +8 -6
  36. package/dist/engine/boot-validator/agent-effect-rules.d.ts +12 -0
  37. package/dist/engine/boot-validator/agent-effect-rules.js +12 -0
  38. package/dist/engine/boot-validator/agent-effect.d.ts +2 -0
  39. package/dist/engine/boot-validator/agent-effect.js +20 -0
  40. package/dist/engine/boot-validator/boot-context.js +5 -1
  41. package/dist/engine/boot-validator/boot-environment-rules.d.ts +12 -0
  42. package/dist/engine/boot-validator/boot-environment-rules.js +12 -0
  43. package/dist/engine/boot-validator/boot-phases-app.js +5 -1
  44. package/dist/engine/boot-validator/boot-phases.js +3 -1
  45. package/dist/engine/boot-validator/boot-rules.d.ts +2619 -0
  46. package/dist/engine/boot-validator/boot-rules.js +58 -0
  47. package/dist/engine/boot-validator/bundled-lists-table.js +23 -9
  48. package/dist/engine/boot-validator/config-deps.js +71 -23
  49. package/dist/engine/boot-validator/config-edit-action-rules.d.ts +17 -0
  50. package/dist/engine/boot-validator/config-edit-action-rules.js +17 -0
  51. package/dist/engine/boot-validator/config-key-rules.d.ts +117 -0
  52. package/dist/engine/boot-validator/config-key-rules.js +117 -0
  53. package/dist/engine/boot-validator/custom-screen-write-qns.js +6 -2
  54. package/dist/engine/boot-validator/derived-sql-fields-rules.d.ts +77 -0
  55. package/dist/engine/boot-validator/derived-sql-fields-rules.js +77 -0
  56. package/dist/engine/boot-validator/derived-sql-fields.js +53 -17
  57. package/dist/engine/boot-validator/detail-screens.js +10 -4
  58. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +92 -0
  59. package/dist/engine/boot-validator/entity-declaration-rules.js +92 -0
  60. package/dist/engine/boot-validator/entity-handler-access-rules.d.ts +102 -0
  61. package/dist/engine/boot-validator/entity-handler-access-rules.js +102 -0
  62. package/dist/engine/boot-validator/entity-handler.d.ts +0 -7
  63. package/dist/engine/boot-validator/entity-handler.js +259 -355
  64. package/dist/engine/boot-validator/entity-image-variants.d.ts +2 -0
  65. package/dist/engine/boot-validator/entity-image-variants.js +91 -0
  66. package/dist/engine/boot-validator/entity-list-aggregate-options.js +8 -2
  67. package/dist/engine/boot-validator/entity-reference-embedded-rules.d.ts +117 -0
  68. package/dist/engine/boot-validator/entity-reference-embedded-rules.js +117 -0
  69. package/dist/engine/boot-validator/entity-select-image-rules.d.ts +122 -0
  70. package/dist/engine/boot-validator/entity-select-image-rules.js +122 -0
  71. package/dist/engine/boot-validator/entity-select.d.ts +8 -0
  72. package/dist/engine/boot-validator/entity-select.js +197 -0
  73. package/dist/engine/boot-validator/entity-structure-rules.d.ts +107 -0
  74. package/dist/engine/boot-validator/entity-structure-rules.js +107 -0
  75. package/dist/engine/boot-validator/field-conditions-rules.d.ts +92 -0
  76. package/dist/engine/boot-validator/field-conditions-rules.js +92 -0
  77. package/dist/engine/boot-validator/field-conditions.js +67 -22
  78. package/dist/engine/boot-validator/form-derivations-rules.d.ts +77 -0
  79. package/dist/engine/boot-validator/form-derivations-rules.js +77 -0
  80. package/dist/engine/boot-validator/form-derivations.js +52 -18
  81. package/dist/engine/boot-validator/global-tenancy.js +13 -7
  82. package/dist/engine/boot-validator/handler-declaration-rules.d.ts +72 -0
  83. package/dist/engine/boot-validator/handler-declaration-rules.js +72 -0
  84. package/dist/engine/boot-validator/handler-field-references-rules.d.ts +22 -0
  85. package/dist/engine/boot-validator/handler-field-references-rules.js +22 -0
  86. package/dist/engine/boot-validator/handler-field-references.js +14 -6
  87. package/dist/engine/boot-validator/list-bulk-actions-rules.d.ts +42 -0
  88. package/dist/engine/boot-validator/list-bulk-actions-rules.js +42 -0
  89. package/dist/engine/boot-validator/list-bulk-actions.js +29 -11
  90. package/dist/engine/boot-validator/list-column-layout.js +22 -10
  91. package/dist/engine/boot-validator/list-query-rules.d.ts +107 -0
  92. package/dist/engine/boot-validator/list-query-rules.js +107 -0
  93. package/dist/engine/boot-validator/list-table-aggregate-options.js +43 -15
  94. package/dist/engine/boot-validator/list-table-aggregate-query.js +7 -3
  95. package/dist/engine/boot-validator/list-table-aggregate-rules.d.ts +82 -0
  96. package/dist/engine/boot-validator/list-table-aggregate-rules.js +82 -0
  97. package/dist/engine/boot-validator/list-table-export-options.js +19 -7
  98. package/dist/engine/boot-validator/list-table-options.js +33 -13
  99. package/dist/engine/boot-validator/list-table-reject-unknown-keys.js +6 -2
  100. package/dist/engine/boot-validator/list-table-rules.d.ts +132 -0
  101. package/dist/engine/boot-validator/list-table-rules.js +132 -0
  102. package/dist/engine/boot-validator/nav-rules.d.ts +42 -0
  103. package/dist/engine/boot-validator/nav-rules.js +42 -0
  104. package/dist/engine/boot-validator/nav.js +29 -15
  105. package/dist/engine/boot-validator/ownership-rules.d.ts +27 -0
  106. package/dist/engine/boot-validator/ownership-rules.js +27 -0
  107. package/dist/engine/boot-validator/ownership.js +28 -12
  108. package/dist/engine/boot-validator/parent-ref.js +32 -20
  109. package/dist/engine/boot-validator/projection-list-screens.js +76 -35
  110. package/dist/engine/boot-validator/query-output-columns.js +9 -3
  111. package/dist/engine/boot-validator/query-refs.js +20 -10
  112. package/dist/engine/boot-validator/query-rules.d.ts +37 -0
  113. package/dist/engine/boot-validator/query-rules.js +37 -0
  114. package/dist/engine/boot-validator/read-gate.js +14 -10
  115. package/dist/engine/boot-validator/record-owned.js +5 -1
  116. package/dist/engine/boot-validator/related-list-table-rules.js +17 -7
  117. package/dist/engine/boot-validator/screens-actions-rules.d.ts +185 -0
  118. package/dist/engine/boot-validator/screens-actions-rules.js +185 -0
  119. package/dist/engine/boot-validator/screens-actions.js +169 -93
  120. package/dist/engine/boot-validator/screens-dashboard-chart-rules.d.ts +87 -0
  121. package/dist/engine/boot-validator/screens-dashboard-chart-rules.js +87 -0
  122. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +227 -0
  123. package/dist/engine/boot-validator/screens-dashboard-rules.js +227 -0
  124. package/dist/engine/boot-validator/screens-dashboard.js +222 -85
  125. package/dist/engine/boot-validator/screens-forms-layout-rules.d.ts +122 -0
  126. package/dist/engine/boot-validator/screens-forms-layout-rules.js +122 -0
  127. package/dist/engine/boot-validator/screens-forms-rules.d.ts +152 -0
  128. package/dist/engine/boot-validator/screens-forms-rules.js +152 -0
  129. package/dist/engine/boot-validator/screens-forms.js +240 -112
  130. package/dist/engine/boot-validator/screens-kind-config-edit.js +72 -16
  131. package/dist/engine/boot-validator/screens-kind-entity-edit.js +15 -7
  132. package/dist/engine/boot-validator/screens-kind-entity-list.js +57 -32
  133. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +92 -0
  134. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +92 -0
  135. package/dist/engine/boot-validator/screens-kind-projection-detail.js +85 -47
  136. package/dist/engine/boot-validator/screens-kind-rules.d.ts +137 -0
  137. package/dist/engine/boot-validator/screens-kind-rules.js +137 -0
  138. package/dist/engine/boot-validator/screens-kind-secret-mint.js +18 -8
  139. package/dist/engine/boot-validator/screens-kind-shared.js +40 -22
  140. package/dist/engine/boot-validator/screens-lists-rules.d.ts +82 -0
  141. package/dist/engine/boot-validator/screens-lists-rules.js +82 -0
  142. package/dist/engine/boot-validator/screens-lists.js +90 -45
  143. package/dist/engine/boot-validator/screens-rules.d.ts +57 -0
  144. package/dist/engine/boot-validator/screens-rules.js +57 -0
  145. package/dist/engine/boot-validator/screens.js +17 -12
  146. package/dist/engine/boot-validator/transaction-phases.js +12 -4
  147. package/dist/engine/boot-validator/transfer-graph.js +17 -11
  148. package/dist/engine/boot-validator/url-prefill-fields.js +9 -5
  149. package/dist/engine/boot-validator/workspaces.js +11 -5
  150. package/dist/engine/boot-validator/zod-shape.js +6 -2
  151. package/dist/engine/entity-handlers.d.ts +1 -0
  152. package/dist/engine/entity-handlers.js +3 -0
  153. package/dist/engine/entity-list-runtime-options.js +23 -29
  154. package/dist/engine/extensions/tenant-data.d.ts +3 -0
  155. package/dist/engine/extensions/tenant-resource.d.ts +1 -0
  156. package/dist/engine/factories.d.ts +1 -1
  157. package/dist/engine/factories.js +4 -3
  158. package/dist/engine/feature-config-events-jobs.js +7 -0
  159. package/dist/engine/index.d.ts +4 -2
  160. package/dist/engine/index.js +2 -0
  161. package/dist/engine/project-app-schema-for-roles.js +29 -14
  162. package/dist/engine/registry-facade.js +7 -8
  163. package/dist/engine/registry-validate.js +5 -1
  164. package/dist/engine/soft-delete-cleanup.d.ts +1 -0
  165. package/dist/engine/soft-delete-cleanup.js +5 -0
  166. package/dist/engine/steps/describe-workflow-step-error.js +1 -0
  167. package/dist/es-ops/operations-schema.d.ts +1 -1
  168. package/dist/event-store/ensure-dead-letter-table.d.ts +2 -0
  169. package/dist/event-store/ensure-dead-letter-table.js +10 -0
  170. package/dist/event-store/rebuild-dead-letter.js +2 -8
  171. package/dist/event-store/upcaster-dead-letter.js +2 -8
  172. package/dist/files/copy-pending-file-refs-to-tenant.d.ts +28 -0
  173. package/dist/files/copy-pending-file-refs-to-tenant.js +87 -0
  174. package/dist/files/file-routes.d.ts +1 -1
  175. package/dist/files/file-routes.js +21 -6
  176. package/dist/files/index.d.ts +2 -0
  177. package/dist/files/index.js +1 -0
  178. package/dist/i18n/required-surface-keys.js +1 -0
  179. package/dist/jobs/job-runner-helpers.js +1 -0
  180. package/dist/jobs/job-runner-schedulers.d.ts +2 -2
  181. package/dist/jobs/job-runner-schedulers.js +8 -4
  182. package/dist/jobs/job-runner.js +14 -16
  183. package/dist/logging/utils.js +30 -60
  184. package/dist/observability/metrics-handle.js +10 -21
  185. package/dist/pipeline/cascade-handler.js +7 -6
  186. package/dist/pipeline/dispatch-query.js +18 -5
  187. package/dist/pipeline/dispatch-shared.d.ts +1 -0
  188. package/dist/pipeline/dispatch-shared.js +3 -1
  189. package/dist/pipeline/dispatch-write.js +10 -12
  190. package/dist/pipeline/dispatcher.js +12 -14
  191. package/dist/pipeline/event-dispatcher-admin.js +9 -8
  192. package/dist/pipeline/event-dispatcher-delivery.d.ts +19 -1
  193. package/dist/pipeline/event-dispatcher-delivery.js +121 -29
  194. package/dist/pipeline/event-dispatcher.d.ts +5 -1
  195. package/dist/pipeline/event-dispatcher.js +28 -21
  196. package/dist/pipeline/handler-context-phase-denials.js +2 -0
  197. package/dist/pipeline/multi-stream-apply-context.js +12 -20
  198. package/dist/pipeline/system-hooks.d.ts +4 -1
  199. package/dist/pipeline/system-hooks.js +79 -6
  200. package/dist/pipeline/system-identity-switch.js +10 -7
  201. package/dist/search/build-search-snippet.d.ts +9 -0
  202. package/dist/search/build-search-snippet.js +40 -0
  203. package/dist/search/index.d.ts +1 -0
  204. package/dist/search/index.js +1 -0
  205. package/dist/search/meilisearch-adapter.d.ts +32 -0
  206. package/dist/search/meilisearch-adapter.js +153 -56
  207. package/dist/search/meilisearch-chunking.d.ts +21 -0
  208. package/dist/search/meilisearch-chunking.js +96 -0
  209. package/dist/search/reindex-entity.d.ts +1 -0
  210. package/dist/search/reindex-entity.js +97 -52
  211. package/dist/ui-types/index.d.ts +1 -1
  212. package/dist/upgrade-cli.js +3 -14
  213. package/package.json +3 -3
  214. package/src/changes.json +85 -0
@@ -4,28 +4,269 @@
4
4
 
5
5
  `validateBoot` reports every violation as `- [<id>] <message>`, followed by a `Fix:` and a `Rule:` line that links the entry below. Violations with an `unclassified/<check>` id have no entry yet. `kumiko-schema validate --json` returns the same ids.
6
6
 
7
+ ## agent-effect
8
+
9
+ | Rule | Summary | Fix | Source |
10
+ | --- | --- | --- | --- |
11
+ | <a id="agent-effect-proposal-needs-low-risk"></a>`agent-effect/proposal-needs-low-risk` | A write handler with agent.effect "proposal" declares agent.risk "low". | Set agent.risk to "low", or drop agent.effect so the agent asks for approval. | `packages/framework/src/engine/boot-validator/agent-effect-rules.ts` |
12
+ | <a id="agent-effect-write-only"></a>`agent-effect/write-only` | Only write handlers declare agent.effect; a query has nothing to approve. | Drop agent.effect from the query handler. | `packages/framework/src/engine/boot-validator/agent-effect-rules.ts` |
13
+
7
14
  ## api
8
15
 
9
16
  | Rule | Summary | Fix | Source |
10
17
  | --- | --- | --- | --- |
18
+ | <a id="api-duplicate-exposed-name"></a>`api/duplicate-exposed-name` | A cross-feature API name is exposed by exactly one feature. | Rename the API in one of the exposing features. | `packages/framework/src/engine/boot-validator/boot-environment-rules.ts` |
11
19
  | <a id="api-provider-not-mounted"></a>`api/provider-not-mounted` | The feature exposing a used API is part of the app's feature list. | Register the provider feature in the app's feature list. | `packages/framework/src/engine/boot-validator/api-ext-rules.ts` |
12
20
  | <a id="api-provider-not-required"></a>`api/provider-not-required` | A feature using an API lists the exposing feature in requires or optionalRequires. | Add the exposing feature via r.requires({ features: [...] }). | `packages/framework/src/engine/boot-validator/api-ext-rules.ts` |
13
21
  | <a id="api-unknown-api"></a>`api/unknown-api` | Every r.usesApi name is exposed by some mounted feature. | Mount the feature that exposes the API or fix the API name. | `packages/framework/src/engine/boot-validator/api-ext-rules.ts` |
14
22
 
23
+ ## auth-foundation
24
+
25
+ | Rule | Summary | Fix | Source |
26
+ | --- | --- | --- | --- |
27
+ | <a id="auth-foundation-no-token-verifier-or-session-store"></a>`auth-foundation/no-token-verifier-or-session-store` | At least one tokenVerifier provider or a sessionStore is registered alongside auth-foundation. | Mount an auth-provider-* feature (e.g. auth-provider-jwt / personal-access-tokens) or a sessionStore (e.g. sessions). | `packages/bundled-features/src/auth-foundation/boot-rules.ts` |
28
+ | <a id="auth-foundation-single-provider-invalid-shape"></a>`auth-foundation/single-provider-invalid-shape` | A single-provider extension registration carries the options shape its provider type requires. | Register the provider with the options shape named in the error message. | `packages/bundled-features/src/auth-foundation/boot-rules.ts` |
29
+ | <a id="auth-foundation-single-provider-multiple"></a>`auth-foundation/single-provider-multiple` | At most one provider of a single-provider extension is mounted at a time. | Unmount all but one provider. | `packages/bundled-features/src/auth-foundation/boot-rules.ts` |
30
+ | <a id="auth-foundation-token-verifier-invalid-plugin"></a>`auth-foundation/token-verifier-invalid-plugin` | A tokenVerifier provider registers a valid AuthProviderPlugin with a { shape, build } options shape. | Register the provider with options of shape { shape, build }. | `packages/bundled-features/src/auth-foundation/boot-rules.ts` |
31
+ | <a id="auth-foundation-token-verifier-shape-collision"></a>`auth-foundation/token-verifier-shape-collision` | No two tokenVerifier providers claim the same token shape, so resolveTokenVerifier can route unambiguously. | Give each provider a distinct shape. | `packages/bundled-features/src/auth-foundation/boot-rules.ts` |
32
+
15
33
  ## boot-check
16
34
 
17
35
  | Rule | Summary | Fix | Source |
18
36
  | --- | --- | --- | --- |
19
37
  | <a id="boot-check-failed"></a>`boot-check/failed` | A feature's r.bootCheck invariant holds for the mounted feature set. | Satisfy the invariant named in the message or unmount the feature that declares it. | `packages/framework/src/engine/boot-validator/boot-check-rules.ts` |
20
38
 
39
+ ## bundled-lists
40
+
41
+ | Rule | Summary | Fix | Source |
42
+ | --- | --- | --- | --- |
43
+ | <a id="bundled-lists-not-object"></a>`bundled-lists/not-object` | The bundledLists option is an object. | Write bundledLists as an object such as { table: { columnPicker: true } }. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
44
+ | <a id="bundled-lists-pin-first-column-not-boolean"></a>`bundled-lists/pin-first-column-not-boolean` | bundledLists.pinFirstColumn is a boolean. | Set pinFirstColumn to true or false. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
45
+ | <a id="bundled-lists-pin-first-column-without-pinning"></a>`bundled-lists/pin-first-column-without-pinning` | bundledLists.pinFirstColumn needs bundledLists.table.pinning. | Set bundledLists.table.pinning: true or remove pinFirstColumn. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
46
+ | <a id="bundled-lists-screen-only-table-key"></a>`bundled-lists/screen-only-table-key` | bundledLists.table leaves out grouping and totals, which depend on one list's fields. | Set grouping and totals in the table block of the individual screen. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
47
+ | <a id="bundled-lists-table-not-object"></a>`bundled-lists/table-not-object` | bundledLists.table is an object. | Write bundledLists.table as an object such as { columnPicker: true }. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
48
+ | <a id="bundled-lists-unknown-key"></a>`bundled-lists/unknown-key` | bundledLists uses only the allowed keys. | Remove the unknown keys or rename them to one of the allowed keys. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
49
+
50
+ ## config-edit
51
+
52
+ | Rule | Summary | Fix | Source |
53
+ | --- | --- | --- | --- |
54
+ | <a id="config-edit-config-key-unknown"></a>`config-edit/config-key-unknown` | A configKeys entry names a config key declared in a feature. | Use an existing <feature>:config:<short> key. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
55
+ | <a id="config-edit-field-type-missing"></a>`config-edit/field-type-missing` | Every configEdit field declares a type. | Set type on the field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
56
+ | <a id="config-edit-field-without-config-key"></a>`config-edit/field-without-config-key` | Every configEdit field maps to a config key in configKeys. | Add the field to configKeys with a <feature>:config:<short> key. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
57
+ | <a id="config-edit-fields-empty"></a>`config-edit/fields-empty` | A configEdit screen declares at least one field. | Declare at least one field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
58
+ | <a id="config-edit-layout-unknown-field"></a>`config-edit/layout-unknown-field` | A configEdit layout names a declared field. | Name a declared field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
59
+ | <a id="config-edit-secret-key-unknown-field"></a>`config-edit/secret-key-unknown-field` | secretKeys names declared fields. | Name a declared field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
60
+ | <a id="config-edit-write-only-not-encrypted"></a>`config-edit/write-only-not-encrypted` | A writeOnly configEdit field maps to an encrypted config key. | Declare the key with encrypted: true or backing: "secrets". | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
61
+
62
+ ## config-edit-action
63
+
64
+ | Rule | Summary | Fix | Source |
65
+ | --- | --- | --- | --- |
66
+ | <a id="config-edit-action-duplicate-id"></a>`config-edit-action/duplicate-id` | A configEdit screen declares each action id once. | Rename or remove the repeated action id. | `packages/framework/src/engine/boot-validator/config-edit-action-rules.ts` |
67
+ | <a id="config-edit-action-unknown-after-field"></a>`config-edit-action/unknown-after-field` | A configEdit action sits after a field that is part of the layout. | Set afterField to a field name that appears in one of the layout sections. | `packages/framework/src/engine/boot-validator/config-edit-action-rules.ts` |
68
+ | <a id="config-edit-action-unknown-handler"></a>`config-edit-action/unknown-handler` | A configEdit action points at a registered write handler. | Use the qualified write handler name "<feature>:write:<handler>" of a registered handler. | `packages/framework/src/engine/boot-validator/config-edit-action-rules.ts` |
69
+
70
+ ## config-key
71
+
72
+ | Rule | Summary | Fix | Source |
73
+ | --- | --- | --- | --- |
74
+ | <a id="config-key-bounds-min-above-max"></a>`config-key/bounds-min-above-max` | A config key's bounds.min is at or below its bounds.max. | Set bounds.min to a value at or below bounds.max. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
75
+ | <a id="config-key-bounds-non-number"></a>`config-key/bounds-non-number` | A config key declares bounds only when its type is number. | Remove bounds or change the key type to "number". | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
76
+ | <a id="config-key-computed-and-encrypted"></a>`config-key/computed-and-encrypted` | A config key is either encrypted (encrypted or backing="secrets") or computed, never both. | Use either encrypted/backing="secrets" or a computed resolver on the key. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
77
+ | <a id="config-key-conditional-options"></a>`config-key/conditional-options` | A config key does not declare conditionalOptions, which only entity select fields support. | Remove conditionalOptions from the config key. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
78
+ | <a id="config-key-default-above-max"></a>`config-key/default-above-max` | A config key's default is not above its bounds.max. | Lower the default or raise bounds.max. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
79
+ | <a id="config-key-default-below-min"></a>`config-key/default-below-min` | A config key's default is not below its bounds.min. | Raise the default or lower bounds.min. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
80
+ | <a id="config-key-options-and-options-query"></a>`config-key/options-and-options-query` | A config key declares either static options or optionsQuery, not both. | Remove options or optionsQuery. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
81
+ | <a id="config-key-options-query-empty"></a>`config-key/options-query-empty` | A config key's optionsQuery is a non-empty query name when present. | Set it to a query name or remove it. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
82
+ | <a id="config-key-options-query-not-select"></a>`config-key/options-query-not-select` | A config key declares optionsQuery only when its type is "select". | Change the key type to "select" or remove optionsQuery. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
83
+ | <a id="config-key-options-query-payload-self-reference"></a>`config-key/options-query-payload-self-reference` | A config key's optionsQueryPayload does not reference the key itself. | Reference a different config key. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
84
+ | <a id="config-key-options-query-payload-unknown-key"></a>`config-key/options-query-payload-unknown-key` | A config key's optionsQueryPayload references only config keys of the same feature. | Reference an existing config key of the feature or remove the entry. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
85
+ | <a id="config-key-options-query-payload-without-query"></a>`config-key/options-query-payload-without-query` | A config key that declares optionsQueryPayload also declares optionsQuery. | Set optionsQuery or remove optionsQueryPayload. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
86
+ | <a id="config-key-options-query-per-request"></a>`config-key/options-query-per-request` | A config key with optionsQuery does not set allowPerRequest, which would bypass the option set unchecked. | Remove allowPerRequest or optionsQuery. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
87
+ | <a id="config-key-per-request-encrypted"></a>`config-key/per-request-encrypted` | A config key with encrypted/backing="secrets" does not set allowPerRequest. | Remove allowPerRequest or the secrets storage from the key. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
88
+ | <a id="config-key-per-request-text"></a>`config-key/per-request-text` | A config key of type "text" does not set allowPerRequest (XSS/injection risk). | Remove allowPerRequest or change the key type. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
89
+ | <a id="config-key-pii-encrypted-and-encrypted"></a>`config-key/pii-encrypted-and-encrypted` | A config key uses piiEncrypted or encrypted/backing="secrets", never both. | Pick one of piiEncrypted (subject-KMS) or encrypted (shared cipher). | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
90
+ | <a id="config-key-pii-encrypted-not-text"></a>`config-key/pii-encrypted-not-text` | A config key with piiEncrypted has type "text". | Use type="text" or remove piiEncrypted. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
91
+ | <a id="config-key-pii-encrypted-system-scope"></a>`config-key/pii-encrypted-system-scope` | A config key with piiEncrypted is not system-scoped, because system scope has no subject to encrypt under. | Use scope="tenant" or "user", or remove piiEncrypted. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
92
+ | <a id="config-key-required-with-computed"></a>`config-key/required-with-computed` | A computed config key is not marked required, because it can never be missing. | Drop required or the computed resolver. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
93
+ | <a id="config-key-required-with-default"></a>`config-key/required-with-default` | A required config key has no non-empty default, otherwise it can never be unset and readiness never flags it. | Use default "" or drop required. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
94
+ | <a id="config-key-secrets-scope-not-system"></a>`config-key/secrets-scope-not-system` | A config key with backing="secrets" has scope "system", because secrets storage does not cascade. | Set scope to "system" or drop backing="secrets". | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
95
+ | <a id="config-key-unknown-config-read"></a>`config-key/unknown-config-read` | A feature reads only config keys that some feature defines. | Declare the key via r.config(...) in a feature, or fix the key name. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
96
+
97
+ ## dashboard
98
+
99
+ | Rule | Summary | Fix | Source |
100
+ | --- | --- | --- | --- |
101
+ | <a id="dashboard-action-drawer"></a>`dashboard/action-drawer` | A dashboard action is not a drawer action. | Use a navigate, writeHandler or clientAction action. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
102
+ | <a id="dashboard-action-redirect"></a>`dashboard/action-redirect` | A dashboard writeHandler action does not set redirect. | Remove redirect from the action. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
103
+ | <a id="dashboard-action-row-click"></a>`dashboard/action-row-click` | A dashboard action does not set rowClick. | Remove rowClick from the action. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
104
+ | <a id="dashboard-actions-without-record"></a>`dashboard/actions-without-record` | A dashboard with actions declares a record binding. | Add record: { param } or remove actions. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
105
+ | <a id="dashboard-chart-color-invalid"></a>`dashboard/chart-color-invalid` | Chart series and marker colors are non-empty CSS colors. | Set a non-empty CSS color. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
106
+ | <a id="dashboard-chart-enum-prop-invalid"></a>`dashboard/chart-enum-prop-invalid` | Stacked-area dateFormat, initialWindow and markerLegend use an allowed value. | Set the prop to one of the allowed values. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
107
+ | <a id="dashboard-chart-flag-non-boolean"></a>`dashboard/chart-flag-non-boolean` | Chart flags (scrollable, brush, legendTotals, markerLabels) are booleans. | Use true or false. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
108
+ | <a id="dashboard-chart-from-today-unreachable"></a>`dashboard/chart-from-today-unreachable` | A chart with initialWindow "from-today" has ranges or brush. | Add ranges or brush, or change initialWindow. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
109
+ | <a id="dashboard-chart-marker-label-invalid"></a>`dashboard/chart-marker-label-invalid` | A chart marker label is a non-empty i18n key. | Set a non-empty i18n key or remove label. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
110
+ | <a id="dashboard-chart-marker-look-missing"></a>`dashboard/chart-marker-look-missing` | A chart marker kind sets a tone or a color. | Set tone or color. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
111
+ | <a id="dashboard-chart-marker-tone-invalid"></a>`dashboard/chart-marker-tone-invalid` | A chart marker tone is a known dashboard tone. | Use positive, negative, active or neutral. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
112
+ | <a id="dashboard-chart-ranges-default-unknown"></a>`dashboard/chart-ranges-default-unknown` | ranges.default is one of the option values. | Set default to one of the options. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
113
+ | <a id="dashboard-chart-ranges-months-invalid"></a>`dashboard/chart-ranges-months-invalid` | A chart range option's months is a positive integer. | Set months to a positive integer or remove it. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
114
+ | <a id="dashboard-chart-ranges-option-duplicate"></a>`dashboard/chart-ranges-option-duplicate` | Chart range option values are unique. | Use each option value once. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
115
+ | <a id="dashboard-chart-ranges-option-incomplete"></a>`dashboard/chart-ranges-option-incomplete` | Every chart range option has a non-empty value and label. | Give every option a value and a label. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
116
+ | <a id="dashboard-chart-ranges-options-empty"></a>`dashboard/chart-ranges-options-empty` | Chart ranges declare at least one option. | Add an option to ranges.options. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
117
+ | <a id="dashboard-chart-stacked-area-only"></a>`dashboard/chart-stacked-area-only` | Stacked-area chart props are only set on a "stacked-area" chart. | Remove the props or use chart "stacked-area". | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
118
+ | <a id="dashboard-chart-unit-timeseries-only"></a>`dashboard/chart-unit-timeseries-only` | A chart unit is only set on a "timeseries" chart. | Remove unit or use chart "timeseries". | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
119
+ | <a id="dashboard-custom-panel-no-component"></a>`dashboard/custom-panel-no-component` | A custom panel declares a react or native component. | Declare a react/native component marker. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
120
+ | <a id="dashboard-duplicate-panel-id"></a>`dashboard/duplicate-panel-id` | Panel ids (including stat-group children) are unique within a dashboard. | Give each panel a unique id. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
121
+ | <a id="dashboard-embedded-detail-without-record"></a>`dashboard/embedded-detail-without-record` | Embedding a projectionDetail needs a record binding on the host dashboard. | Add record: { param } to the dashboard or embed another screen type. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
122
+ | <a id="dashboard-embedded-form-navigates"></a>`dashboard/embedded-form-navigates` | An embedded actionForm or secretMint sets neither redirect nor a cancelTarget. | Embed a screen without redirect and with cancelTarget: false (or omitted). | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
123
+ | <a id="dashboard-embedded-screen-type"></a>`dashboard/embedded-screen-type` | A screen panel embeds only an embeddable screen type. | Embed a projectionList, projectionDetail, actionForm, secretMint, configEdit or secretsEdit screen, or use a custom panel. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
124
+ | <a id="dashboard-embedded-screen-unresolved"></a>`dashboard/embedded-screen-unresolved` | A screen panel's screen and fallback resolve to registered screens. | Use a same-feature short id or a cross-feature QN "<feature>:screen:<id>". | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
125
+ | <a id="dashboard-empty-panels"></a>`dashboard/empty-panels` | A dashboard declares at least one panel. | Add a panel to panels. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
126
+ | <a id="dashboard-filter-id-empty"></a>`dashboard/filter-id-empty` | The dashboard filter has a non-empty id. | Set a non-empty filter.id. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
127
+ | <a id="dashboard-filter-label-empty"></a>`dashboard/filter-label-empty` | The dashboard filter has a non-empty label. | Set a non-empty filter.label. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
128
+ | <a id="dashboard-filter-options-empty"></a>`dashboard/filter-options-empty` | Static filter options are non-empty. | Declare at least one option or use optionsQuery. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
129
+ | <a id="dashboard-filter-options-query-empty"></a>`dashboard/filter-options-query-empty` | filter.optionsQuery is non-empty when set. | Set optionsQuery to a query name or remove it. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
130
+ | <a id="dashboard-filter-options-xor"></a>`dashboard/filter-options-xor` | The dashboard filter sets exactly one of options and optionsQuery. | Keep either options or optionsQuery. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
131
+ | <a id="dashboard-list-panel-columns-empty"></a>`dashboard/list-panel-columns-empty` | A list panel declares at least one column. | Add at least one column. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
132
+ | <a id="dashboard-panel-fallback-gated"></a>`dashboard/panel-fallback-gated` | A panel fallback screen has no visibleWhen of its own. | Embed a fallback screen without visibleWhen. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
133
+ | <a id="dashboard-panel-fallback-without-visible-when"></a>`dashboard/panel-fallback-without-visible-when` | A screen panel with a fallback also declares visibleWhen. | Add visibleWhen or remove fallback. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
134
+ | <a id="dashboard-panel-query-empty"></a>`dashboard/panel-query-empty` | A stat, stat-group child and query panel names a non-empty query string. | Set query to a registered query name. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
135
+ | <a id="dashboard-panel-span-invalid"></a>`dashboard/panel-span-invalid` | A panel's span is "half" or "full". | Set span to "half" or "full". | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
136
+ | <a id="dashboard-panel-visible-when-incomplete"></a>`dashboard/panel-visible-when-incomplete` | A panel's visibleWhen names a non-empty query and field. | Set both visibleWhen.query and visibleWhen.field. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
137
+ | <a id="dashboard-record-param-collision"></a>`dashboard/record-param-collision` | record.param and payloadKey differ from the filter and timeRange ids. | Use a different name for the record param or the filter/timeRange id. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
138
+ | <a id="dashboard-record-param-empty"></a>`dashboard/record-param-empty` | record.param is a non-empty string. | Name the URL search param carrying the record id. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
139
+ | <a id="dashboard-record-payload-key-empty"></a>`dashboard/record-payload-key-empty` | record.payloadKey is non-empty when set. | Omit payloadKey to reuse record.param, or name a key. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
140
+ | <a id="dashboard-record-query-empty"></a>`dashboard/record-query-empty` | record.query is non-empty when set. | Set a registered query name or omit record.query. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
141
+ | <a id="dashboard-record-title-field-unusable"></a>`dashboard/record-title-field-unusable` | record.titleField needs record.query and a non-empty field name. | Add record.query and name a field, or remove titleField. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
142
+ | <a id="dashboard-refresh-field-empty"></a>`dashboard/refresh-field-empty` | refresh.field is non-empty. | Name the record field holding the seconds. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
143
+ | <a id="dashboard-refresh-field-without-record-query"></a>`dashboard/refresh-field-without-record-query` | A field-driven refresh has a record.query to read the seconds from. | Add record: { param, query } or use refresh: { seconds }. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
144
+ | <a id="dashboard-refresh-seconds-and-field"></a>`dashboard/refresh-seconds-and-field` | A dashboard refresh sets either seconds or field, not both. | Keep exactly one of seconds and field. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
145
+ | <a id="dashboard-refresh-seconds-too-short"></a>`dashboard/refresh-seconds-too-short` | refresh.seconds is a number of at least DASHBOARD_MIN_REFRESH_SECONDS. | Raise refresh.seconds to the minimum or more. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
146
+ | <a id="dashboard-stat-group-child-visible-when"></a>`dashboard/stat-group-child-visible-when` | Stat-group children do not set visibleWhen. | Gate the whole group with visibleWhen instead. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
147
+ | <a id="dashboard-stat-group-empty"></a>`dashboard/stat-group-empty` | A stat-group declares at least one stat. | Add at least one stat. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
148
+ | <a id="dashboard-stat-group-subtitle-without-label"></a>`dashboard/stat-group-subtitle-without-label` | A stat-group with a subtitle also has a label. | Set a label or remove subtitle. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
149
+ | <a id="dashboard-stat-value-field-empty"></a>`dashboard/stat-value-field-empty` | A stat panel and stat-group child has a non-empty valueField. | Set valueField to a field of the query result. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
150
+ | <a id="dashboard-text-link-roles-empty"></a>`dashboard/text-link-roles-empty` | A text link block's roles list is non-empty when set. | List the roles or omit roles. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
151
+ | <a id="dashboard-text-link-unresolved"></a>`dashboard/text-link-unresolved` | A text link block's screen resolves to a registered screen. | Use a same-feature short id or a cross-feature QN "<feature>:screen:<id>". | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
152
+ | <a id="dashboard-text-list-block-empty"></a>`dashboard/text-list-block-empty` | A text list block has items. | Add items or remove the block. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
153
+ | <a id="dashboard-text-panel-empty"></a>`dashboard/text-panel-empty` | A text panel declares at least one block. | Add at least one block. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
154
+ | <a id="dashboard-time-range-default-unknown"></a>`dashboard/time-range-default-unknown` | timeRange.default is one of the option values. | Set default to one of the options. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
155
+ | <a id="dashboard-time-range-id-collides-filter"></a>`dashboard/time-range-id-collides-filter` | The timeRange id differs from the filter id. | Use a timeRange.id different from the filter id. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
156
+ | <a id="dashboard-time-range-id-empty"></a>`dashboard/time-range-id-empty` | The dashboard timeRange has a non-empty id. | Set a non-empty timeRange.id. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
157
+ | <a id="dashboard-time-range-option-duplicate"></a>`dashboard/time-range-option-duplicate` | timeRange option values are unique. | Use each option value once. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
158
+ | <a id="dashboard-time-range-option-incomplete"></a>`dashboard/time-range-option-incomplete` | Every timeRange option has a non-empty value and label. | Give every option a value and a label. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
159
+ | <a id="dashboard-time-range-options-empty"></a>`dashboard/time-range-options-empty` | The timeRange declares at least one option. | Add an option to timeRange.options. | `packages/framework/src/engine/boot-validator/screens-dashboard-rules.ts` |
160
+ | <a id="dashboard-value-format-currency"></a>`dashboard/value-format-currency` | A currency valueFormat uses a 3-letter uppercase ISO currency code. | Set currency to an ISO 4217 code such as "EUR". | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
161
+ | <a id="dashboard-value-format-fraction-digits"></a>`dashboard/value-format-fraction-digits` | valueFormat.fractionDigits is an integer from 0 to the maximum. | Set fractionDigits to an integer within range. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
162
+ | <a id="dashboard-value-format-kind"></a>`dashboard/value-format-kind` | A valueFormat kind is allowed for the panel type. | Use an allowed kind for this panel type. | `packages/framework/src/engine/boot-validator/screens-dashboard-chart-rules.ts` |
163
+
164
+ ## derived-field
165
+
166
+ | Rule | Summary | Fix | Source |
167
+ | --- | --- | --- | --- |
168
+ | <a id="derived-field-active-on-not-date"></a>`derived-field/active-on-not-date` | The activeOn from/to fields are date fields. | Use date fields for activeOn.from and activeOn.to. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
169
+ | <a id="derived-field-coalesce-empty"></a>`derived-field/coalesce-empty` | A coalesce derived field lists at least one field. | Add fields to coalesce. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
170
+ | <a id="derived-field-coalesce-mixed-types"></a>`derived-field/coalesce-mixed-types` | All coalesce fields have the same type. | Coalesce fields of one type. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
171
+ | <a id="derived-field-encrypted-field"></a>`derived-field/encrypted-field` | A SQL derived field does not read encrypted or secret fields. | Read a field that is neither encrypted nor secret. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
172
+ | <a id="derived-field-in-operator-list"></a>`derived-field/in-operator-list` | A where condition with op "in" takes a list, and only "in" does. | Use a list value exactly with op "in". | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
173
+ | <a id="derived-field-label-needs-reference"></a>`derived-field/label-needs-reference` | A measure with label: true reads a reference field (with a labelField). | Measure a reference field that declares a labelField, or drop label: true. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
174
+ | <a id="derived-field-money-needs-sql"></a>`derived-field/money-needs-sql` | A derived field with valueType "money" is a sql derived field. | Use a sql related first measure on a money field. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
175
+ | <a id="derived-field-null-operator"></a>`derived-field/null-operator` | A where condition with a null value uses op eq or ne. | Use op eq or ne for null, or give a value. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
176
+ | <a id="derived-field-relative-date-field-type"></a>`derived-field/relative-date-field-type` | A where condition with today needs a date field and with now a timestamp field. | Compare today with a date field and now with a timestamp field. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
177
+ | <a id="derived-field-sortable-needs-join-index"></a>`derived-field/sortable-needs-join-index` | A sortable related derived field has an index on the related table's join column. | Declare indexes: [{ columns: ["<field>"] }] on the related entity. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
178
+ | <a id="derived-field-sortable-needs-sql"></a>`derived-field/sortable-needs-sql` | Only sql derived fields are sortable. | Make the field a sql derived field or drop sortable. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
179
+ | <a id="derived-field-unknown-field"></a>`derived-field/unknown-field` | Every field a SQL derived field reads is a field of the entity. | Name an existing field of the entity (or of the related entity). | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
180
+ | <a id="derived-field-unknown-related-entity"></a>`derived-field/unknown-related-entity` | The related entity of a derived field is registered. | Register the entity or fix the entity name. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
181
+ | <a id="derived-field-unsupported-field-type"></a>`derived-field/unsupported-field-type` | A SQL derived field reads only scalar field types. | Read a text, number, decimal, boolean, date or timestamp field; money only as the measure of a related first. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
182
+ | <a id="derived-field-value-type-mismatch"></a>`derived-field/value-type-mismatch` | The derived field's valueType matches the type of the value it computes. | Set valueType to the expected value type. | `packages/framework/src/engine/boot-validator/derived-sql-fields-rules.ts` |
183
+
184
+ ## document-ingest-foundation
185
+
186
+ | Rule | Summary | Fix | Source |
187
+ | --- | --- | --- | --- |
188
+ | <a id="document-ingest-foundation-job-unknown-provider"></a>`document-ingest-foundation/job-unknown-provider` | A documentIngest.requested job filters to a provider that some feature registers via EXT_DOCUMENT_INGEST_PROVIDER. | Register the provider via r.useExtension(EXT_DOCUMENT_INGEST_PROVIDER, "<name>", ...) or fix the provider name. | `packages/bundled-features/src/document-ingest-foundation/boot-rules.ts` |
189
+ | <a id="document-ingest-foundation-job-without-provider-filter"></a>`document-ingest-foundation/job-without-provider-filter` | A job triggered by documentIngest.requested filters to one provider, so it does not fire for every provider's uploads. | Use trigger: documentIngestProviderTrigger("<name>"). | `packages/bundled-features/src/document-ingest-foundation/boot-rules.ts` |
190
+ | <a id="document-ingest-foundation-provider-without-job"></a>`document-ingest-foundation/provider-without-job` | A registered document-ingest provider has a job triggered by documentIngestProviderTrigger, otherwise requested files are never processed. | Add an r.job with that trigger, or unmount the provider. | `packages/bundled-features/src/document-ingest-foundation/boot-rules.ts` |
191
+
192
+ ## embedded-field
193
+
194
+ | Rule | Summary | Fix | Source |
195
+ | --- | --- | --- | --- |
196
+ | <a id="embedded-field-decimal-scale-invalid"></a>`embedded-field/decimal-scale-invalid` | A decimal sub-field scale is an integer between 0 and 15. | Set scale to an integer between 0 and 15. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
197
+ | <a id="embedded-field-derived-cell-not-in-schema"></a>`embedded-field/derived-cell-not-in-schema` | Every derived cell is a sub-field in the embedded schema. | Add the sub-field to the schema or remove the derived cell. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
198
+ | <a id="embedded-field-derived-source-is-derived"></a>`embedded-field/derived-source-is-derived` | A derived cell reads stored sub-fields, not other derived cells. | Read only stored sub-fields. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
199
+ | <a id="embedded-field-derived-source-not-numeric"></a>`embedded-field/derived-source-not-numeric` | A derived cell reads only number, decimal or money sub-fields. | Point from at number, decimal or money sub-fields of the same row. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
200
+ | <a id="embedded-field-derived-source-unknown"></a>`embedded-field/derived-source-unknown` | A derived cell reads only sub-fields that exist in the schema. | Read an existing sub-field. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
201
+ | <a id="embedded-field-derived-target-not-numeric"></a>`embedded-field/derived-target-not-numeric` | The target of a derived cell is a number, decimal or money sub-field. | Change the target sub-field's type to number, decimal or money. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
202
+ | <a id="embedded-field-derived-when-reads-derived"></a>`embedded-field/derived-when-reads-derived` | A derived cell's when reads a stored sub-field, not another derived cell. | Read a stored sub-field in when. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
203
+ | <a id="embedded-field-file-sub-field-in-derived"></a>`embedded-field/file-sub-field-in-derived` | File sub-fields are not used in derived cells or totals. | Remove the file sub-field from derived, totals and totalsMatch. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
204
+ | <a id="embedded-field-in-range-needs-three-sources"></a>`embedded-field/in-range-needs-three-sources` | A derived cell with op "inRange" has exactly three sources (value, min, max). | List exactly value, min and max in from. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
205
+ | <a id="embedded-field-in-range-target-not-select"></a>`embedded-field/in-range-target-not-select` | The target of an "inRange" derived cell is a select sub-field with the inside and outside options. | Make the target a select sub-field that lists both the inside and the outside option. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
206
+ | <a id="embedded-field-list-options-on-non-list"></a>`embedded-field/list-options-on-non-list` | minItems, maxItems, derived, totals and totalsMatch are set only on embedded lists. | Set multiple: true or remove the options. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
207
+ | <a id="embedded-field-max-items-too-small"></a>`embedded-field/max-items-too-small` | An embedded list maxItems is at least 1. | Set maxItems to 1 or more. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
208
+ | <a id="embedded-field-min-items-above-max"></a>`embedded-field/min-items-above-max` | An embedded list minItems is not greater than maxItems. | Set minItems at or below maxItems. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
209
+ | <a id="embedded-field-min-items-negative"></a>`embedded-field/min-items-negative` | An embedded list minItems is at least 0. | Set minItems to 0 or more. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
210
+ | <a id="embedded-field-option-tone-not-an-option"></a>`embedded-field/option-tone-not-an-option` | Every optionTones key of a select sub-field is one of its options. | Remove the tone or add the option. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
211
+ | <a id="embedded-field-percent-needs-two-sources"></a>`embedded-field/percent-needs-two-sources` | A derived cell with op "percent" has exactly two sources (base, rate). | List base and rate in from. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
212
+ | <a id="embedded-field-required-min-items-zero"></a>`embedded-field/required-min-items-zero` | A required embedded list does not set minItems: 0. | Drop minItems or set required: false. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
213
+ | <a id="embedded-field-schema-empty"></a>`embedded-field/schema-empty` | An embedded field declares at least one sub-field. | Declare a sub-field in the embedded schema. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
214
+ | <a id="embedded-field-select-options-empty"></a>`embedded-field/select-options-empty` | A select sub-field has at least one option. | Add an option. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
215
+ | <a id="embedded-field-sub-field-type-invalid"></a>`embedded-field/sub-field-type-invalid` | An embedded sub-field uses an allowed sub-field type. | Use one of the allowed embedded sub-field types. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
216
+ | <a id="embedded-field-totals-from-empty"></a>`embedded-field/totals-from-empty` | A totals entry lists at least one source in from. | List a number, money or decimal sub-field. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
217
+ | <a id="embedded-field-totals-match-key-not-money"></a>`embedded-field/totals-match-key-not-money` | A totalsMatch key is a money sub-field of the schema. | Use a money sub-field as the totalsMatch key. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
218
+ | <a id="embedded-field-totals-match-sibling-not-money"></a>`embedded-field/totals-match-sibling-not-money` | A totalsMatch value maps to a money field of the entity. | Map it to a money field of the entity. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
219
+ | <a id="embedded-field-totals-not-numeric"></a>`embedded-field/totals-not-numeric` | Totals list only number, money or decimal sub-fields. | List only number, money or decimal sub-fields. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
220
+
221
+ ## entity
222
+
223
+ | Rule | Summary | Fix | Source |
224
+ | --- | --- | --- | --- |
225
+ | <a id="entity-derived-field-collision"></a>`entity/derived-field-collision` | A derivedFields key does not match a stored field. | Rename the derivedFields key or the stored field. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
226
+ | <a id="entity-encrypted-filterable"></a>`entity/encrypted-filterable` | An encrypted text field is not filterable. | Drop filterable: true or remove the encryption. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
227
+ | <a id="entity-encrypted-searchable"></a>`entity/encrypted-searchable` | An encrypted text field is not searchable. | Drop searchable: true or remove the encryption. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
228
+ | <a id="entity-encrypted-sortable"></a>`entity/encrypted-sortable` | An encrypted text field is not sortable. | Drop sortable: true or remove the encryption. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
229
+ | <a id="entity-extend-schema-collision"></a>`entity/extend-schema-collision` | An extendSchema column does not collide with an entity field. | Rename the extension column or the entity field. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
230
+ | <a id="entity-global-without-system-scope"></a>`entity/global-without-system-scope` | A feature that owns an entity with tenancy "global" declares r.systemScope(). | Declare r.systemScope() in the owning feature. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
231
+ | <a id="entity-global-without-system-stream"></a>`entity/global-without-system-stream` | An entity with tenancy "global" also declares systemStream: true. | Declare systemStream: true on the entity. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
232
+ | <a id="entity-located-by-missing-field"></a>`entity/located-by-missing-field` | A timestamp locatedBy names a field of the same entity. | Declare the tz field or use createLocatedTimestampField(). | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
233
+ | <a id="entity-located-by-not-tz"></a>`entity/located-by-not-tz` | A timestamp locatedBy points at a tz field. | Point locatedBy at a field of type tz. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
234
+ | <a id="entity-searchable-restricted-read"></a>`entity/searchable-restricted-read` | A searchable field has no restricted access.read. | Drop searchable/find: "fuzzy" or access.read. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
235
+
236
+ ## entity-edit
237
+
238
+ | Rule | Summary | Fix | Source |
239
+ | --- | --- | --- | --- |
240
+ | <a id="entity-edit-read-only-field-unknown"></a>`entity-edit/read-only-field-unknown` | The readOnly condition field is a field of the screen's entity. | Name an existing entity field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
241
+ | <a id="entity-edit-record-title-field-unknown"></a>`entity-edit/record-title-field-unknown` | recordTitleField is a field of the screen's entity. | Name an existing entity field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
242
+
243
+ ## entity-index
244
+
245
+ | Rule | Summary | Fix | Source |
246
+ | --- | --- | --- | --- |
247
+ | <a id="entity-index-columns-empty"></a>`entity-index/columns-empty` | An entity index lists at least one column. | Add a column to the index. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
248
+ | <a id="entity-index-long-text-column"></a>`entity-index/long-text-column` | An index does not cover a longText field. | Use text if the column needs an index, or use the SearchAdapter. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
249
+ | <a id="entity-index-multi-value-column"></a>`entity-index/multi-value-column` | An index does not cover a multi-value field. | Use a single-value field or remove it from the index. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
250
+ | <a id="entity-index-tenant-id-only"></a>`entity-index/tenant-id-only` | A non-unique index is not on tenantId alone. | Remove the entry; buildEntityTable creates it automatically. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
251
+ | <a id="entity-index-unique-encrypted-column"></a>`entity-index/unique-encrypted-column` | A unique index does not cover an encrypted column. | Remove unique or encrypted. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
252
+ | <a id="entity-index-unknown-column"></a>`entity-index/unknown-column` | Every index column is a field of the entity or a base column. | Fix the column name. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
253
+
21
254
  ## entity-list
22
255
 
23
256
  | Rule | Summary | Fix | Source |
24
257
  | --- | --- | --- | --- |
258
+ | <a id="entity-list-create-screen-unresolved"></a>`entity-list/create-screen-unresolved` | createScreen resolves to a registered screen in the same feature. | Point createScreen at a screen of this feature. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
259
+ | <a id="entity-list-cross-feature-edit-needs-entity-id"></a>`entity-list/cross-feature-edit-needs-entity-id` | A rowAction navigating to a cross-feature entityEdit screen sets entityId. | Set entityId to the row field naming the target entity's id. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
25
260
  | <a id="entity-list-default-sort-not-listed"></a>`entity-list/default-sort-not-listed` | defaultSort.field is one of the listed columns. | Pick a field from columns or add it there. | `packages/framework/src/engine/boot-validator/entity-list-screens-rules.ts` |
26
261
  | <a id="entity-list-default-sort-not-sortable"></a>`entity-list/default-sort-not-sortable` | The defaultSort column is sortable. | Mark the field sortable or pick another defaultSort field. | `packages/framework/src/engine/boot-validator/entity-list-screens-rules.ts` |
27
262
  | <a id="entity-list-default-sort-required"></a>`entity-list/default-sort-required` | A list with active search or filterable fields declares a defaultSort. | Set defaultSort: { field, direction } on the screen. | `packages/framework/src/engine/boot-validator/entity-list-screens-rules.ts` |
263
+ | <a id="entity-list-default-sort-unknown-field"></a>`entity-list/default-sort-unknown-field` | defaultSort.field is a field of the entity. | Name an existing entity field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
28
264
  | <a id="entity-list-detail-without-navigate"></a>`entity-list/detail-without-navigate` | A list whose entity has a detail screen offers a navigate row action. | Add a navigate rowAction with id "view" or "edit". | `packages/framework/src/engine/boot-validator/entity-list-screens-rules.ts` |
265
+ | <a id="entity-list-filter-field-not-allowed"></a>`entity-list/filter-field-not-allowed` | A screen filter does not target an encrypted, personal or secret field the list handler rejects. | Drop the filter or filter on another field; personal fields only allow op eq with find exact or fuzzy. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
266
+ | <a id="entity-list-filter-field-not-filterable"></a>`entity-list/filter-field-not-filterable` | A screen filter targets a filterable field. | Set filterable: true on the field or pick another field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
267
+ | <a id="entity-list-filter-op-not-allowed"></a>`entity-list/filter-op-not-allowed` | A screen filter uses an op allowed for the field type. | Use one of the allowed ops for the field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
268
+ | <a id="entity-list-filter-unknown-field"></a>`entity-list/filter-unknown-field` | A screen filter names a field of the entity. | Name an existing entity field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
269
+ | <a id="entity-list-page-size-invalid"></a>`entity-list/page-size-invalid` | pageSize is a positive integer. | Set pageSize to a positive integer. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
29
270
  | <a id="entity-list-searchable-false"></a>`entity-list/searchable-false` | Operator lists are searchable unless they are on the searchable-false whitelist. | Set searchable: true or add the screen id to the whitelist. | `packages/framework/src/engine/boot-validator/entity-list-screens-rules.ts` |
30
271
  | <a id="entity-list-unknown-column"></a>`entity-list/unknown-column` | Every column without a label names an entity field, derived field or row-meta column. | Fix the column field name or give the column a label. | `packages/framework/src/engine/boot-validator/entity-list-screens-rules.ts` |
31
272
  | <a id="entity-list-unknown-named-filter"></a>`entity-list/unknown-named-filter` | Every screen namedFilters id is declared in the entity's namedFilters. | Declare the rule in EntityDefinition.namedFilters or remove the id from the screen. | `packages/framework/src/engine/boot-validator/entity-list-screens-rules.ts` |
@@ -34,9 +275,155 @@
34
275
 
35
276
  | Rule | Summary | Fix | Source |
36
277
  | --- | --- | --- | --- |
278
+ | <a id="extension-presave-without-mapped-write"></a>`extension/presave-without-mapped-write` | An extension with preSave is used only on entities that have an entity-mapped write handler. | Use create/update/delete on a matching entity or name the handler "entity:verb". | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
37
279
  | <a id="extension-provider-not-required"></a>`extension/provider-not-required` | A feature using an extension lists the defining feature in requires or optionalRequires. | Add the defining feature via r.requires({ features: [...] }). | `packages/framework/src/engine/boot-validator/api-ext-rules.ts` |
38
280
  | <a id="extension-unknown-extension"></a>`extension/unknown-extension` | Every extension a feature uses is defined by some mounted feature. | Register the feature that defines the extension or fix the extension name. | `packages/framework/src/engine/boot-validator/api-ext-rules.ts` |
39
281
 
282
+ ## feature
283
+
284
+ | Rule | Summary | Fix | Source |
285
+ | --- | --- | --- | --- |
286
+ | <a id="feature-circular-dependency"></a>`feature/circular-dependency` | Feature requires() links form no cycle. | Break the cycle by removing one requires() link. | `packages/framework/src/engine/boot-validator/config-key-rules.ts` |
287
+
288
+ ## field-condition
289
+
290
+ | Rule | Summary | Fix | Source |
291
+ | --- | --- | --- | --- |
292
+ | <a id="field-condition-comparison-value-not-option"></a>`field-condition/comparison-value-not-option` | A condition on a select field compares only against options of that field. | Compare against one of the select field's options. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
293
+ | <a id="field-condition-field-type-not-comparable"></a>`field-condition/field-type-not-comparable` | A visibleWhen, requiredWhen or lockedWhen field stores a plain scalar the condition can compare. | Use a text, select, boolean, number or reference field (more types for sub-fields). | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
294
+ | <a id="field-condition-on-own-field"></a>`field-condition/on-own-field` | A visibleWhen, requiredWhen or when condition depends on a different field or sibling. | Point the condition's field at another field of the entity (or a sibling sub-field). | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
295
+ | <a id="field-condition-required-with-required-when"></a>`field-condition/required-with-required-when` | A field does not set required: true together with requiredWhen. | Drop required; requiredWhen covers the conditional case. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
296
+ | <a id="field-condition-required-with-visible-when"></a>`field-condition/required-with-visible-when` | A field does not set required: true together with visibleWhen. | Drop required and use requiredWhen with the same condition as visibleWhen. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
297
+ | <a id="field-condition-unknown-field"></a>`field-condition/unknown-field` | A condition's field names a field of the entity or a sub-field of the same row. | Use an existing field of the entity, or a sibling sub-field inside an embedded row. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
298
+
299
+ ## file-field
300
+
301
+ | Rule | Summary | Fix | Source |
302
+ | --- | --- | --- | --- |
303
+ | <a id="file-field-accept-entry-empty"></a>`file-field/accept-entry-empty` | The accept list has no empty entries. | List file extensions like "pdf". | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
304
+ | <a id="file-field-accept-entry-not-bare-extension"></a>`file-field/accept-entry-not-bare-extension` | Every accept entry is a bare lower-case file extension. | Use "pdf" instead of ".pdf", a MIME type or a wildcard. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
305
+ | <a id="file-field-max-count-invalid"></a>`file-field/max-count-invalid` | A file sub-field maxCount is a positive integer. | Set maxCount to a positive integer. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
306
+ | <a id="file-field-max-size-invalid"></a>`file-field/max-size-invalid` | A file sub-field maxSize is a parseable size string. | Use a size like "10mb" or "500kb". | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
307
+ | <a id="file-field-sub-field-searchable"></a>`file-field/sub-field-searchable` | A file or image sub-field is not searchable. | Remove searchable from the file sub-field. | `packages/framework/src/engine/boot-validator/field-conditions-rules.ts` |
308
+
309
+ ## file-storage
310
+
311
+ | Rule | Summary | Fix | Source |
312
+ | --- | --- | --- | --- |
313
+ | <a id="file-storage-provider-env-missing"></a>`file-storage/provider-env-missing` | An app with file or image fields sets the FILE_STORAGE_PROVIDER environment variable. | Set FILE_STORAGE_PROVIDER in the environment. | `packages/framework/src/engine/boot-validator/boot-environment-rules.ts` |
314
+
315
+ ## form
316
+
317
+ | Rule | Summary | Fix | Source |
318
+ | --- | --- | --- | --- |
319
+ | <a id="form-affix-unknown-field"></a>`form/affix-unknown-field` | A { field } prefix or suffix names another field of the same form. | Name a field of the same form. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
320
+ | <a id="form-config-secret-also-config-key"></a>`form/config-secret-also-config-key` | A configEdit field is mapped in configKeys or secretKeys, not both. | Keep one of the mappings. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
321
+ | <a id="form-config-secret-field-type"></a>`form/config-secret-field-type` | A secret-mapped configEdit field is a writeOnly text field. | Make the field a writeOnly text field. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
322
+ | <a id="form-config-secret-scope"></a>`form/config-secret-scope` | Secret-mapped configEdit fields are on a tenant- or system-scope screen. | Use scope "tenant" or "system", or drop the secret mapping. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
323
+ | <a id="form-config-secret-undeclared"></a>`form/config-secret-undeclared` | A secret-mapped configEdit field names a secret declared via r.secret(). | Declare the secret with r.secret() or fix the secret name. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
324
+ | <a id="form-confirm-carry-collides-field"></a>`form/confirm-carry-collides-field` | A confirm.carry entry does not share a name with a confirm.fields entry. | Rename the carry entry or the field. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
325
+ | <a id="form-confirm-carry-entry-empty"></a>`form/confirm-carry-entry-empty` | secretMint confirm.carry entries are non-empty strings. | Use non-empty strings in carry. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
326
+ | <a id="form-confirm-layout-draft"></a>`form/confirm-layout-draft` | A secretMint confirm layout does not persist drafts. | Remove draft: true. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
327
+ | <a id="form-confirm-layout-mode"></a>`form/confirm-layout-mode` | A secretMint confirm layout is a single-step form. | Remove mode or set it to "single". | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
328
+ | <a id="form-draft-feature-missing"></a>`form/draft-feature-missing` | A draft layout needs the form-draft feature mounted. | Add createFormDraftFeature() from @cosmicdrift/kumiko-bundled-features to the app's features. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
329
+ | <a id="form-draft-without-wizard"></a>`form/draft-without-wizard` | layout.draft is set only on a wizard layout. | Remove draft: true or set mode: "wizard". | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
330
+ | <a id="form-embedded-list-card-hidden-editable"></a>`form/embedded-list-card-hidden-editable` | embeddedList.cardHiddenCells lists only read-only cells. | Add the cell to readOnlyCells or remove it from cardHiddenCells. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
331
+ | <a id="form-embedded-list-on-non-list-field"></a>`form/embedded-list-on-non-list-field` | embeddedList is set only on an embedded list field. | Remove embeddedList or point it at an embedded list field. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
332
+ | <a id="form-embedded-list-unknown-sub-field"></a>`form/embedded-list-unknown-sub-field` | embeddedList cell options name sub-fields of the embedded schema. | Name an existing sub-field. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
333
+ | <a id="form-extension-section-no-component"></a>`form/extension-section-no-component` | An extension section declares a react or native component. | Declare a react/native component marker. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
334
+ | <a id="form-field-type-missing"></a>`form/field-type-missing` | Every inline form field declares a type. | Declare a type such as "text", "number" or "select". | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
335
+ | <a id="form-fields-empty"></a>`form/fields-empty` | An inline form declares at least one field. | Declare at least one field. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
336
+ | <a id="form-fill-action-field-type"></a>`form/fill-action-field-type` | fillAction targets a text, number, decimal or bigInt field. | Remove fillAction or use a fitting field type. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
337
+ | <a id="form-fill-action-sensitive-field"></a>`form/fill-action-sensitive-field` | fillAction does not target a sensitive, writeOnly or password field. | Remove fillAction. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
338
+ | <a id="form-fill-action-unknown-field"></a>`form/fill-action-unknown-field` | fillAction.params read fields of the same form. | Name fields of the same form in pick or map. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
339
+ | <a id="form-handler-empty"></a>`form/handler-empty` | An inline form's handler is a non-empty string. | Set handler to a non-empty handler name. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
340
+ | <a id="form-layout-unknown-field"></a>`form/layout-unknown-field` | Layout fields name fields of the form. | Name an existing field of the form. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
341
+ | <a id="form-load-singleton-with-id-param"></a>`form/load-singleton-with-id-param` | A singleton actionForm load has no idParam. | Remove idParam. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
342
+ | <a id="form-money-currency-literal-code"></a>`form/money-currency-literal-code` | A literal money currency has a non-empty string code. | Pass the ISO code, for example { kind: "literal", code: "EUR" }. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
343
+ | <a id="form-money-currency-missing"></a>`form/money-currency-missing` | An inline form money field declares its currency source. | Declare currency: { kind: "literal", code } or { kind: "tenant" }. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
344
+ | <a id="form-money-currency-not-object"></a>`form/money-currency-not-object` | A money field's currency is an object. | Declare currency: { kind: "literal", code } or { kind: "tenant" }. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
345
+ | <a id="form-money-currency-unknown-kind"></a>`form/money-currency-unknown-kind` | A money field's currency kind is "literal" or "tenant". | Declare currency: { kind: "literal", code } or { kind: "tenant" }. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
346
+ | <a id="form-options-availability-query-empty"></a>`form/options-availability-query-empty` | optionsAvailabilityQuery is non-empty when set. | Set it to a query name or remove it. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
347
+ | <a id="form-options-query-payload-self-reference"></a>`form/options-query-payload-self-reference` | optionsQueryPayload does not reference its own field. | Reference a different field of the form. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
348
+ | <a id="form-options-query-payload-unknown-field"></a>`form/options-query-payload-unknown-field` | optionsQueryPayload references fields of the same form. | Reference another field of the same form. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
349
+ | <a id="form-options-query-payload-without-query"></a>`form/options-query-payload-without-query` | optionsQueryPayload is set only together with optionsQuery. | Set optionsQuery or remove optionsQueryPayload. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
350
+ | <a id="form-prefill-current-user-field-type"></a>`form/prefill-current-user-field-type` | A currentUser prefill matches the field type. | Use a text field (or text/reference for id) or a different prefill property. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
351
+ | <a id="form-prefill-today-needs-date"></a>`form/prefill-today-needs-date` | The "today" prefill is set only on a date field. | Use a date field or a different prefill. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
352
+ | <a id="form-related-list-section-unsupported"></a>`form/related-list-section-unsupported` | Inline form layouts have no relatedList sections. | Move the section to a projectionDetail screen or remove it. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
353
+ | <a id="form-required-field-without-widget"></a>`form/required-field-without-widget` | A required entityEdit field has a widget to fill it. | Set required: false, move the field to a custom-component section, or drop the required constraint. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
354
+ | <a id="form-section-empty"></a>`form/section-empty` | A section declares at least one field or group. | Drop the section or add fields or groups. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
355
+ | <a id="form-section-fields-and-groups"></a>`form/section-fields-and-groups` | A section declares fields or groups, not both. | Remove `fields: []` when using groups. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
356
+ | <a id="form-sections-empty"></a>`form/sections-empty` | An inline form layout declares at least one section. | Declare at least one section. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
357
+ | <a id="form-select-conditional-options"></a>`form/select-conditional-options` | Inline form select fields do not declare conditionalOptions. | Remove conditionalOptions from the field. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
358
+ | <a id="form-select-options-and-query"></a>`form/select-options-and-query` | A select field declares static options or optionsQuery, not both. | Pick one of options and optionsQuery. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
359
+ | <a id="form-select-options-query-empty"></a>`form/select-options-query-empty` | A select field's optionsQuery is non-empty when set. | Set it to a query name or remove it. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
360
+ | <a id="form-select-query-and-availability"></a>`form/select-query-and-availability` | optionsAvailabilityQuery is not combined with optionsQuery. | Remove optionsAvailabilityQuery or use static options. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
361
+ | <a id="form-success-facts-with-redirect"></a>`form/success-facts-with-redirect` | An actionForm sets either redirect or successFacts. | Use one of them. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
362
+ | <a id="form-success-links-with-redirect"></a>`form/success-links-with-redirect` | An actionForm sets either redirect or successLinks. | Use one of them. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
363
+ | <a id="form-tab-id-duplicate"></a>`form/tab-id-duplicate` | Tab section ids are unique. | Give each tab section a unique id. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
364
+ | <a id="form-tab-id-missing"></a>`form/tab-id-missing` | Every tab section has a non-empty id. | Give each tab section a stable id. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
365
+ | <a id="form-tab-id-not-kebab"></a>`form/tab-id-not-kebab` | Tab section ids are kebab-case. | Rename the section id to kebab-case. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
366
+ | <a id="form-tab-title-missing"></a>`form/tab-title-missing` | Every tab section has a non-empty title. | Give each tab section a title. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
367
+ | <a id="form-tabs-too-few-sections"></a>`form/tabs-too-few-sections` | A tabs layout has at least two sections. | Add a section or use another mode. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
368
+ | <a id="form-tabs-unsupported-screen-type"></a>`form/tabs-unsupported-screen-type` | Tabs layout is used only on projectionDetail and entityEdit screens. | Use mode: "wizard" or "single". | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
369
+ | <a id="form-wizard-step-title-missing"></a>`form/wizard-step-title-missing` | Every wizard section has a non-empty title. | Give each wizard section a title. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
370
+ | <a id="form-wizard-too-few-sections"></a>`form/wizard-too-few-sections` | A wizard layout has at least two sections. | Add a section or use another mode. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
371
+ | <a id="form-write-form-section-unsupported"></a>`form/write-form-section-unsupported` | Inline form layouts have no writeForm sections. | Move the section to a projectionDetail screen or remove it. | `packages/framework/src/engine/boot-validator/screens-forms-layout-rules.ts` |
372
+ | <a id="form-write-only-field"></a>`form/write-only-field` | Inline form fields do not declare writeOnly. | Remove writeOnly; use format: "password" for a masked input. | `packages/framework/src/engine/boot-validator/screens-forms-rules.ts` |
373
+
374
+ ## form-derive
375
+
376
+ | Rule | Summary | Fix | Source |
377
+ | --- | --- | --- | --- |
378
+ | <a id="form-derive-cell-not-numeric"></a>`form-derive/cell-not-numeric` | The cell of a listSum derivation is a money, number or decimal sub-field. | Name a numeric sub-field of the list. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
379
+ | <a id="form-derive-handler-not-wrapped"></a>`form-derive/handler-not-wrapped` | A screen that declares derive uses a handler wrapped with withFormDerivations. | Wrap the handler schema: withFormDerivations(schema, screen) with this screen object. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
380
+ | <a id="form-derive-invalid-order"></a>`form-derive/invalid-order` | Derivations have a valid evaluation order (no cycles). | Remove the dependency cycle between derived fields. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
381
+ | <a id="form-derive-list-not-embedded-list"></a>`form-derive/list-not-embedded-list` | The list of a listSum derivation is an embedded list field. | Use an embedded field with multiple: true. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
382
+ | <a id="form-derive-list-sum-kind-mismatch"></a>`form-derive/list-sum-kind-mismatch` | A listSum target is money exactly when its cell is money. | Change the target field type to match the cell. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
383
+ | <a id="form-derive-percent-needs-two-sources"></a>`form-derive/percent-needs-two-sources` | A "percent" derivation has exactly two sources (base, rate). | List base and rate in from. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
384
+ | <a id="form-derive-source-not-numeric"></a>`form-derive/source-not-numeric` | Every derivation source is a money, number or decimal field. | Use money, number or decimal source fields. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
385
+ | <a id="form-derive-sources-money-mixed"></a>`form-derive/sources-money-mixed` | The sources of a sum or subtract derivation are all money or all number/decimal. | Use sources of one kind. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
386
+ | <a id="form-derive-target-kind-mismatch"></a>`form-derive/target-kind-mismatch` | A derivation's target is money exactly when its sources are money. | Change the target field type to match the sources. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
387
+ | <a id="form-derive-target-not-numeric"></a>`form-derive/target-not-numeric` | A derived field is a money, number or decimal field. | Change the target field type to money, number or decimal. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
388
+ | <a id="form-derive-too-many-money-sources"></a>`form-derive/too-many-money-sources` | A derivation other than sum/subtract takes at most one money source. | Use at most one money source (for percent: the base, not the rate). | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
389
+ | <a id="form-derive-unknown-list-field"></a>`form-derive/unknown-list-field` | The list of a listSum derivation is a field of the screen. | Name a field of this screen. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
390
+ | <a id="form-derive-unknown-source-field"></a>`form-derive/unknown-source-field` | Every derivation source is a field of the screen. | Name a field of this screen. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
391
+ | <a id="form-derive-unknown-target"></a>`form-derive/unknown-target` | Every derive key is a field of the screen. | Use a field name of this screen as key. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
392
+ | <a id="form-derive-when-empty-list-sum"></a>`form-derive/when-empty-list-sum` | whenEmpty of a listSum is not itself a listSum. | Use a from-based derivation as whenEmpty. | `packages/framework/src/engine/boot-validator/form-derivations-rules.ts` |
393
+
394
+ ## handler
395
+
396
+ | Rule | Summary | Fix | Source |
397
+ | --- | --- | --- | --- |
398
+ | <a id="handler-access-all-role"></a>`handler/access-all-role` | Handler access does not list the role "all". | Use roles: ["anonymous"] plus an ip rateLimit, or openToAll: { reason }. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
399
+ | <a id="handler-access-missing"></a>`handler/access-missing` | Every write, query and stream handler declares an access rule. | Set access: { roles: [...] } or { openToAll: { reason } }. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
400
+ | <a id="handler-access-personal-data-unknown"></a>`handler/access-personal-data-unknown` | access.personalData is "public-intake" when set. | Use personalData: "public-intake" or remove it. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
401
+ | <a id="handler-anonymous-personal-data-undeclared"></a>`handler/anonymous-personal-data-undeclared` | A write handler that allows anonymous callers and accepts personal-data fields declares access.personalData "public-intake". | Declare access: { roles: [..., "anonymous"], personalData: "public-intake" }. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
402
+ | <a id="handler-escape-hatch-grants-invalid"></a>`handler/escape-hatch-grants-invalid` | An escapeHatch declares valid grants. | Correct the escapeHatch grants as named in the error message. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
403
+ | <a id="handler-escape-hatch-reason-invalid"></a>`handler/escape-hatch-reason-invalid` | An escapeHatch carries a valid reason. | Write an escapeHatch reason that explains the bypass. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
404
+ | <a id="handler-input-schema-not-introspectable"></a>`handler/input-schema-not-introspectable` | A write handler's input schema is a Zod shape whose keys boot can collect. | Use an object schema the boot validator can walk, as named in the error message. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
405
+ | <a id="handler-nested-skip-with-reserve-before-transaction"></a>`handler/nested-skip-with-reserve-before-transaction` | A write handler with beforeTransactionWhenNested does not declare reserveBeforeTransaction, because a nested run would run unreserved. | Remove reserveBeforeTransaction or beforeTransactionWhenNested. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
406
+ | <a id="handler-nested-skip-without-before-transaction"></a>`handler/nested-skip-without-before-transaction` | A write handler with beforeTransactionWhenNested also declares beforeTransaction. | Declare beforeTransaction or remove beforeTransactionWhenNested. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
407
+ | <a id="handler-open-to-all-personal-data-unbound"></a>`handler/open-to-all-personal-data-unbound` | An openToAll write handler accepts personal-data fields only when they are bound to the caller or explicitly declared tenant-members. | Bind rows to the caller, restrict access to roles, or declare openToAll: { reason, personalData: "tenant-members" }. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
408
+ | <a id="handler-open-to-all-personal-data-unknown"></a>`handler/open-to-all-personal-data-unknown` | openToAll.personalData is "tenant-members" when set. | Use personalData: "tenant-members" or remove it. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
409
+ | <a id="handler-open-to-all-reason-invalid"></a>`handler/open-to-all-reason-invalid` | An openToAll declaration is an object with a valid reason explaining why any authenticated user may call the handler. | Declare { openToAll: { reason: "<explanation>" } }. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
410
+ | <a id="handler-per-command-with-phase"></a>`handler/per-command-with-phase` | A write handler with transaction "perCommand" declares neither beforeTransaction nor reserveBeforeTransaction. | Move the phase into the commands the handler issues via ctx.dispatch.write. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
411
+ | <a id="handler-personal-data-unsupported-for-kind"></a>`handler/personal-data-unsupported-for-kind` | A personalData declaration appears only on handler kinds whose input is checked for personal-data fields. | Remove the personalData declaration from this handler. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
412
+ | <a id="handler-public-intake-rate-limit-disabled"></a>`handler/public-intake-rate-limit-disabled` | A handler with access.personalData "public-intake" keeps its rateLimit enabled, because it is the only protection for anonymous personal-data writes. | Declare rateLimit: { per: "ip" or "ip+handler", ... } instead of disabling it. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
413
+ | <a id="handler-public-intake-without-anonymous"></a>`handler/public-intake-without-anonymous` | A handler with access.personalData "public-intake" allows the anonymous role. | Add the anonymous role to access.roles or remove personalData. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
414
+ | <a id="handler-tenantless-anonymous-access"></a>`handler/tenantless-anonymous-access` | A tenantlessAnonymous handler allows exactly the anonymous role. | Set access to { roles: ["anonymous"] } or remove tenantlessAnonymous. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
415
+ | <a id="handler-tenantless-anonymous-rate-limit-per"></a>`handler/tenantless-anonymous-rate-limit-per` | A tenantlessAnonymous handler rate-limits per ip or ip+handler. | Use per "ip" or "ip+handler". | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
416
+ | <a id="handler-tenantless-anonymous-without-rate-limit"></a>`handler/tenantless-anonymous-without-rate-limit` | A tenantlessAnonymous handler declares an active rateLimit. | Set rateLimit: { per: "ip", ... }; disabled does not count. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
417
+
418
+ ## handler-schema
419
+
420
+ | Rule | Summary | Fix | Source |
421
+ | --- | --- | --- | --- |
422
+ | <a id="handler-schema-invalid-references"></a>`handler-schema/invalid-references` | A references meta on an input field is an entity name, feature:entity or { entity, by? }. | Use "<entity>", "<feature>:<entity>" or { entity, by? }. | `packages/framework/src/engine/boot-validator/handler-field-references-rules.ts` |
423
+ | <a id="handler-schema-unknown-references-by"></a>`handler-schema/unknown-references-by` | The by field of a references meta is a field of the referenced entity. | Use an existing field of that entity for by. | `packages/framework/src/engine/boot-validator/handler-field-references-rules.ts` |
424
+ | <a id="handler-schema-unknown-references-entity"></a>`handler-schema/unknown-references-entity` | The entity a references meta names is registered. | Use "<entity>" for this feature or "<feature>:<entity>" for another one. | `packages/framework/src/engine/boot-validator/handler-field-references-rules.ts` |
425
+ | <a id="handler-schema-zod-walk-limit"></a>`handler-schema/zod-walk-limit` | A handler schema has a finite node count when walked. | Hoist a z.lazy() getter that returns a new schema on every call into a constant. | `packages/framework/src/engine/boot-validator/handler-field-references-rules.ts` |
426
+
40
427
  ## i18n
41
428
 
42
429
  | Rule | Summary | Fix | Source |
@@ -47,11 +434,134 @@
47
434
  | <a id="i18n-missing-required-locale"></a>`i18n/missing-required-locale` | Every translation key exists in every locale the app requires. | Load the matching locale package or add the missing translations. | `packages/framework/src/engine/boot-validator/i18n-keys-rules.ts` |
48
435
  | <a id="i18n-missing-settings-hub-key"></a>`i18n/missing-settings-hub-key` | Every translation key the generated settings hub requires is defined. | Add the key via r.translations(...) in the owning feature. | `packages/framework/src/engine/boot-validator/i18n-keys-rules.ts` |
49
436
 
437
+ ## image-variant
438
+
439
+ | Rule | Summary | Fix | Source |
440
+ | --- | --- | --- | --- |
441
+ | <a id="image-variant-blur-invalid"></a>`image-variant/blur-invalid` | An image variant blur is a finite number in (0, max]. | Fix blur. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
442
+ | <a id="image-variant-blur-region-invalid"></a>`image-variant/blur-region-invalid` | Image variant blurRegions lie within the unit square. | Keep x/y/width/height within 0..1. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
443
+ | <a id="image-variant-max-edge-invalid"></a>`image-variant/max-edge-invalid` | An image variant maxEdge is a positive integer up to the edge limit. | Fix maxEdge. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
444
+ | <a id="image-variant-name-invalid"></a>`image-variant/name-invalid` | An image variant name matches the variant name pattern. | Rename the variant. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
445
+ | <a id="image-variant-quality-invalid"></a>`image-variant/quality-invalid` | An image variant quality is an integer in 1..100. | Fix quality. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
446
+ | <a id="image-variant-size-and-max-edge"></a>`image-variant/size-and-max-edge` | An image variant sets size or maxEdge, not both. | Pick one. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
447
+ | <a id="image-variant-size-invalid"></a>`image-variant/size-invalid` | An image variant size is a positive integer up to the edge limit. | Fix width and height. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
448
+
50
449
  ## list
51
450
 
52
451
  | Rule | Summary | Fix | Source |
53
452
  | --- | --- | --- | --- |
54
453
  | <a id="list-card-meta-overflow"></a>`list/card-meta-overflow` | A card list shows at most the maximum number of meta columns. | Reduce each list to the maximum number of meta columns or mark the others hideOnNarrow: true. | `packages/framework/src/engine/boot-validator/card-meta-overflow-rules.ts` |
454
+ | <a id="list-column-renderer-component-invalid"></a>`list/column-renderer-component-invalid` | A column renderer's react.__component is a non-empty string. | Set react.__component to the name of a client columnRenderers entry. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
455
+ | <a id="list-column-renderer-react-not-object"></a>`list/column-renderer-react-not-object` | A column renderer's react branch is an object. | Use { react: { __component: "Name" } }. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
456
+ | <a id="list-column-sortable-inert"></a>`list/column-sortable-inert` | A column only sets sortable where the screen type honors it. | Remove sortable from the column. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
457
+ | <a id="list-empty-state-action-params"></a>`list/empty-state-action-params` | Empty-state actions set no params, because an empty list has no row to read them from. | Remove the params. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
458
+ | <a id="list-enum-option-tones-invalid"></a>`list/enum-option-tones-invalid` | enumOption column tones are known select option tones. | Use only the allowed tones (SELECT_OPTION_TONES). | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
459
+ | <a id="list-facet-duplicate"></a>`list/facet-duplicate` | Each facet field is declared once. | Declare each facet field once. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
460
+ | <a id="list-facet-query-unregistered"></a>`list/facet-query-unregistered` | A reference facet loads its options from a registered query handler. | Register the entity's list handler (defineEntityListHandler). | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
461
+ | <a id="list-facet-select-no-options"></a>`list/facet-select-no-options` | A select facet declares at least one option. | Declare at least one option. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
462
+ | <a id="list-facet-unknown-column"></a>`list/facet-unknown-column` | A non-reference facet names a declared column. | Name a declared column or add the column. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
463
+ | <a id="list-ref-target-entity-unknown"></a>`list/ref-target-entity-unknown` | An entity reference target resolves to a registered entity. | Name an entity the target feature registers. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
464
+ | <a id="list-ref-target-feature-not-mounted"></a>`list/ref-target-feature-not-mounted` | An entity reference target belongs to a mounted feature. | Mount the feature and declare it in r.requires({ features }). | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
465
+ | <a id="list-related-read-only-with-row-interaction"></a>`list/related-read-only-with-row-interaction` | A readOnly relatedList section declares no rowClick or rowActions. | Remove readOnly or the row interaction. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
466
+ | <a id="list-related-row-click-no-detail"></a>`list/related-row-click-no-detail` | A relatedList rowClick entity target has a screen declaring detailFor for it. | Add detailFor to the screen that shows the entity. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
467
+ | <a id="list-related-toolbar-visible-when"></a>`list/related-toolbar-visible-when` | relatedList toolbarActions use visible instead of visibleWhen. | Use visible, a condition on the enclosing record. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
468
+ | <a id="list-screen-id-unresolved"></a>`list/screen-id-unresolved` | listScreenId names a mounted screen. | Fix the listScreenId or mount the list screen. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
469
+ | <a id="list-screen-unreachable"></a>`list/screen-unreachable` | A screen without a nav entry has a resolvable list, or is marked dormant. | Declare listScreenId, add a standalone r.nav() pointing at it, or set dormant: true. | `packages/framework/src/engine/boot-validator/screens-lists-rules.ts` |
470
+
471
+ ## list-bulk
472
+
473
+ | Rule | Summary | Fix | Source |
474
+ | --- | --- | --- | --- |
475
+ | <a id="list-bulk-entry-not-object"></a>`list-bulk/entry-not-object` | Every bulkActions entry is an object with id and rowAction. | Write each entry as { id, rowAction }. | `packages/framework/src/engine/boot-validator/list-bulk-actions-rules.ts` |
476
+ | <a id="list-bulk-id-duplicate"></a>`list-bulk/id-duplicate` | Bulk action ids are unique within a list. | Rename or remove the duplicate bulk action. | `packages/framework/src/engine/boot-validator/list-bulk-actions-rules.ts` |
477
+ | <a id="list-bulk-id-not-kebab"></a>`list-bulk/id-not-kebab` | A bulk action id is a kebab-case string. | Rename the id to kebab-case. | `packages/framework/src/engine/boot-validator/list-bulk-actions-rules.ts` |
478
+ | <a id="list-bulk-not-array"></a>`list-bulk/not-array` | bulkActions is a non-empty array. | Write bulkActions as [{ id: "archive", rowAction: "archive" }] or remove it. | `packages/framework/src/engine/boot-validator/list-bulk-actions-rules.ts` |
479
+ | <a id="list-bulk-row-action-missing"></a>`list-bulk/row-action-missing` | A bulk action names the id of a row action in rowAction. | Set rowAction to the id of a declared row action. | `packages/framework/src/engine/boot-validator/list-bulk-actions-rules.ts` |
480
+ | <a id="list-bulk-row-action-not-write-handler"></a>`list-bulk/row-action-not-write-handler` | Bulk actions run one server write per row, so they point at writeHandler row actions. | Point rowAction at a writeHandler row action. | `packages/framework/src/engine/boot-validator/list-bulk-actions-rules.ts` |
481
+ | <a id="list-bulk-row-action-undeclared"></a>`list-bulk/row-action-undeclared` | A bulk action's rowAction is declared in the list's rowActions. | Declare the row action in rowActions or point rowAction at a declared one. | `packages/framework/src/engine/boot-validator/list-bulk-actions-rules.ts` |
482
+ | <a id="list-bulk-unknown-key"></a>`list-bulk/unknown-key` | A bulk action uses only the allowed keys. | Remove the unknown keys. | `packages/framework/src/engine/boot-validator/list-bulk-actions-rules.ts` |
483
+
484
+ ## list-query
485
+
486
+ | Rule | Summary | Fix | Source |
487
+ | --- | --- | --- | --- |
488
+ | <a id="list-query-count-and-count-field"></a>`list-query/count-and-count-field` | A relatedList section declares either count or countField. | Pick one badge source. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
489
+ | <a id="list-query-count-needs-tabs-layout"></a>`list-query/count-needs-tabs-layout` | A relatedList section with count: true sits in a layout with mode "tabs". | Use mode "tabs" or remove count. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
490
+ | <a id="list-query-count-param-missing"></a>`list-query/count-param-missing` | A relatedList section with count: true binds a query that accepts limit and totalCount. | Add the missing parameter to the query's Zod schema. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
491
+ | <a id="list-query-date-range-param-missing"></a>`list-query/date-range-param-missing` | The query accepts every param a dateRange facet sends. | Add the param to the handler's schema or point params at keys it already accepts. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
492
+ | <a id="list-query-date-range-param-reused"></a>`list-query/date-range-param-reused` | Each dateRange facet on a screen uses its own param names. | Give each dateRange facet its own param names. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
493
+ | <a id="list-query-date-range-reserved-param"></a>`list-query/date-range-reserved-param` | A dateRange facet bound does not use a reserved list-payload key. | Pick the query's own time-bound param names. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
494
+ | <a id="list-query-date-range-same-param"></a>`list-query/date-range-same-param` | A dateRange facet names different params for its from and to bounds. | Use two different param names for from and to. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
495
+ | <a id="list-query-default-sort-required"></a>`list-query/default-sort-required` | A projectionList with active search or sort declares a defaultSort. | Set defaultSort: { field, direction } on the screen. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
496
+ | <a id="list-query-derived-flag-hand-authored"></a>`list-query/derived-flag-hand-authored` | A projectionList sets neither sortable nor paginated, both come from the query's Zod schema. | Remove sortable and paginated from the screen. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
497
+ | <a id="list-query-facets-without-filters-param"></a>`list-query/facets-without-filters-param` | A list that declares facets sent as filters binds a query with a "filters" parameter. | Add a filters parameter to the handler's schema, or reuse entityListSchema's shape. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
498
+ | <a id="list-query-filter-param-missing"></a>`list-query/filter-param-missing` | A projectionList that declares filter binds a query with a "filter" parameter. | Add a filter parameter to the handler's schema, or reuse entityListSchema's shape. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
499
+ | <a id="list-query-parent-filter-and-parent-param"></a>`list-query/parent-filter-and-parent-param` | A relatedList section declares parentFilter or parentParam, not both. | Remove parentParam or drop parentFilter. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
500
+ | <a id="list-query-parent-filter-field-unknown"></a>`list-query/parent-filter-field-unknown` | parentFilter.field is a declared field of the entity behind the section's query. | Use one of the known fields named in the message. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
501
+ | <a id="list-query-parent-filter-param-missing"></a>`list-query/parent-filter-param-missing` | A relatedList section with parentFilter binds a query with a "filter" parameter. | Add a filter parameter to the handler's schema, or reuse entityListSchema's shape. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
502
+ | <a id="list-query-searchable-false-disables-search"></a>`list-query/searchable-false-disables-search` | A projectionList whose query accepts "search" is searchable unless it is on the searchable-false whitelist. | Remove searchable: false or add the screen id to SEARCHABLE_FALSE_WHITELIST. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
503
+ | <a id="list-query-searchable-without-search-param"></a>`list-query/searchable-without-search-param` | A searchable list binds a query whose Zod schema has a "search" parameter. | Add a "search" field to the query schema or remove searchable: true. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
504
+ | <a id="list-query-searchable-without-searchable-field"></a>`list-query/searchable-without-searchable-field` | A searchable projectionList does not list an entity that has no searchable field. | Mark a field searchable: true on the entity or remove searchable: true. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
505
+
506
+ ## list-table
507
+
508
+ | Rule | Summary | Fix | Source |
509
+ | --- | --- | --- | --- |
510
+ | <a id="list-table-aggregate-field-not-column"></a>`list-table/aggregate-field-not-column` | Fields used by table.grouping and table.totals are columns of the screen. | Add the field to the screen's columns or use a listed column. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
511
+ | <a id="list-table-aggregate-field-not-on-entity"></a>`list-table/aggregate-field-not-on-entity` | Fields used by table.grouping and table.totals exist on the entity behind the list. | Use a field of the entity. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
512
+ | <a id="list-table-aggregate-field-secret"></a>`list-table/aggregate-field-secret` | table.grouping and table.totals skip encrypted, personal and secret fields. | Pick a field that is not encrypted, personal or secret. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
513
+ | <a id="list-table-aggregate-param-missing"></a>`list-table/aggregate-param-missing` | A list with table.grouping or table.totals binds a query that accepts aggregate. | Reuse entityListSchema or listAggregatePayloadSchema, answer it with answerListAggregate, or remove grouping and totals. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
514
+ | <a id="list-table-column-min-width-exceeds-width"></a>`list-table/column-min-width-exceeds-width` | A column's minWidth is not greater than its width. | Lower minWidth or raise width. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
515
+ | <a id="list-table-column-pinned-invalid"></a>`list-table/column-pinned-invalid` | A column's pinned value is one of the known pin sides. | Use one of the listed pin values. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
516
+ | <a id="list-table-column-pinned-without-pinning"></a>`list-table/column-pinned-without-pinning` | A pinned column needs table.pinning, otherwise the pin has no effect. | Set table: { pinning: true } or remove pinned from the column. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
517
+ | <a id="list-table-column-width-invalid"></a>`list-table/column-width-invalid` | A column's width and minWidth are finite pixel counts greater than 0. | Set a positive finite number or remove the option. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
518
+ | <a id="list-table-column-width-without-resizing"></a>`list-table/column-width-without-resizing` | A column's width or minWidth needs table.resizing, otherwise it has no effect. | Set table: { resizing: true } or remove width and minWidth from the column. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
519
+ | <a id="list-table-density-default-invalid"></a>`list-table/density-default-invalid` | table.density.default is one of the known densities. | Use one of the listed density values. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
520
+ | <a id="list-table-density-empty"></a>`list-table/density-empty` | table.density sets default and/or userChoice. | Set default and/or userChoice, or remove table.density. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
521
+ | <a id="list-table-density-not-object"></a>`list-table/density-not-object` | table.density is an object. | Write table.density as { default: "compact", userChoice: true }. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
522
+ | <a id="list-table-density-user-choice-not-boolean"></a>`list-table/density-user-choice-not-boolean` | table.density.userChoice is a boolean. | Set userChoice to true or false. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
523
+ | <a id="list-table-export-max-rows-invalid"></a>`list-table/export-max-rows-invalid` | table.export.maxRows is an integer of at least 1. | Set a positive integer row limit or remove maxRows to use the default. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
524
+ | <a id="list-table-export-max-rows-too-large"></a>`list-table/export-max-rows-too-large` | table.export.maxRows stays within the in-memory workbook limit. | Lower maxRows to the allowed maximum. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
525
+ | <a id="list-table-export-not-allowed"></a>`list-table/export-not-allowed` | table.export is only declared on entityList and projectionList screens. | Remove table.export from this screen or section. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
526
+ | <a id="list-table-export-not-object"></a>`list-table/export-not-object` | table.export is an object. | Write table.export as { xlsx: true, maxRows: 5000 }. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
527
+ | <a id="list-table-export-xlsx-not-true"></a>`list-table/export-xlsx-not-true` | table.export.xlsx is true, the only export format. | Set xlsx: true. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
528
+ | <a id="list-table-grouping-field-not-groupable"></a>`list-table/grouping-field-not-groupable` | table.grouping uses only field types that can be grouped by. | Group by a groupable field. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
529
+ | <a id="list-table-grouping-fields-without-user-choice"></a>`list-table/grouping-fields-without-user-choice` | table.grouping.fields comes with userChoice: true, otherwise the user cannot pick them. | Set userChoice: true or remove fields. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
530
+ | <a id="list-table-grouping-no-field"></a>`list-table/grouping-no-field` | table.grouping names a field, or offers fields with userChoice: true. | Set field, or userChoice: true with at least one entry in fields. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
531
+ | <a id="list-table-grouping-not-object"></a>`list-table/grouping-not-object` | table.grouping is an object. | Write table.grouping as { field: "status" }. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
532
+ | <a id="list-table-grouping-value-invalid"></a>`list-table/grouping-value-invalid` | Each table.grouping option has the value type its schema expects. | Change the option to the type named in the message. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
533
+ | <a id="list-table-hidden-not-boolean"></a>`list-table/hidden-not-boolean` | A column's hidden flag is a boolean. | Set hidden to true or remove it. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
534
+ | <a id="list-table-hidden-without-column-picker"></a>`list-table/hidden-without-column-picker` | Hidden columns need table.columnPicker, otherwise the user can never show them. | Set table: { columnPicker: true } or remove hidden from the column. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
535
+ | <a id="list-table-hides-every-column"></a>`list-table/hides-every-column` | At least one list column starts visible. | Remove hidden from one column. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
536
+ | <a id="list-table-not-object"></a>`list-table/not-object` | A list's table option is an object. | Write table as an object such as { rememberState: true } using only the allowed keys. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
537
+ | <a id="list-table-option-not-boolean"></a>`list-table/option-not-boolean` | The boolean table switches (rememberState, columnPicker, pinning, ...) are booleans. | Set the table option to true or false. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
538
+ | <a id="list-table-range-facet-field-type"></a>`list-table/range-facet-field-type` | A facet with display "range" is on a number, decimal, money or bigInt field. | Use another facet display or a numeric field. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
539
+ | <a id="list-table-range-facet-not-filterable"></a>`list-table/range-facet-not-filterable` | A facet with display "range" is on a filterable field that is not encrypted, personal or secret. | Set filterable: true on the field or drop the range facet. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
540
+ | <a id="list-table-total-entry-not-object"></a>`list-table/total-entry-not-object` | Every table.totals entry is an object. | Write each entry as { field, kind }. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
541
+ | <a id="list-table-total-field-not-string"></a>`list-table/total-field-not-string` | A table.totals entry names its field as a string. | Set field to a field name. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
542
+ | <a id="list-table-total-kind-invalid"></a>`list-table/total-kind-invalid` | A table.totals entry uses a supported aggregate kind. | Use one of the listed kinds. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
543
+ | <a id="list-table-total-kind-unsupported"></a>`list-table/total-kind-unsupported` | A table.totals kind is supported on the type of its field. | Use sum or avg on number, decimal, money or bigInt fields; min and max also take date and timestamp. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
544
+ | <a id="list-table-totals-not-array"></a>`list-table/totals-not-array` | table.totals is a non-empty array. | Write table.totals as [{ field: "amount", kind: "sum" }] or remove it. | `packages/framework/src/engine/boot-validator/list-table-aggregate-rules.ts` |
545
+ | <a id="list-table-unknown-keys"></a>`list-table/unknown-keys` | A table option block uses only the keys its schema allows. | Remove the unknown keys or rename them to one of the allowed keys. | `packages/framework/src/engine/boot-validator/list-table-rules.ts` |
546
+
547
+ ## locked-when
548
+
549
+ | Rule | Summary | Fix | Source |
550
+ | --- | --- | --- | --- |
551
+ | <a id="locked-when-ciphertext-field"></a>`locked-when/ciphertext-field` | The lockedWhen field is plaintext at rest. | Use a plaintext field. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
552
+ | <a id="locked-when-read-restricted-field"></a>`locked-when/read-restricted-field` | The lockedWhen field has no read restriction. | Drop field access.read or use another field. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
553
+ | <a id="locked-when-unknown-field"></a>`locked-when/unknown-field` | The lockedWhen field is a field of the entity. | Name an existing field. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
554
+
555
+ ## multi-select
556
+
557
+ | Rule | Summary | Fix | Source |
558
+ | --- | --- | --- | --- |
559
+ | <a id="multi-select-columns-invalid"></a>`multi-select/columns-invalid` | Checkbox columns is 1, 2, 3 or 4. | Use a supported columns value. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
560
+ | <a id="multi-select-columns-without-checkboxes"></a>`multi-select/columns-without-checkboxes` | columns is set only with display: "checkboxes". | Set display: "checkboxes" or drop columns. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
561
+ | <a id="multi-select-default-not-option"></a>`multi-select/default-not-option` | Every multiSelect default value is one of its options. | Use options only in default. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
562
+ | <a id="multi-select-max-rows-invalid"></a>`multi-select/max-rows-invalid` | Checkbox maxRows is a positive integer. | Set maxRows to a positive integer. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
563
+ | <a id="multi-select-max-rows-without-checkboxes"></a>`multi-select/max-rows-without-checkboxes` | maxRows is set only with display: "checkboxes". | Set display: "checkboxes" or drop maxRows. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
564
+ | <a id="multi-select-options-empty"></a>`multi-select/options-empty` | A multiSelect field has at least one option. | Add an option. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
55
565
 
56
566
  ## named-filter
57
567
 
@@ -64,6 +574,37 @@
64
574
  | <a id="named-filter-stat-navigate-static-filter"></a>`named-filter/stat-navigate-static-filter` | A stat repeats the target screen's static filter in params.filter. | Set params.filter to the target screen's filter. | `packages/framework/src/engine/boot-validator/named-filter-rules.ts` |
65
575
  | <a id="named-filter-stat-navigate-target"></a>`named-filter/stat-navigate-target` | A stat navigate.screen resolves to an entityList or projectionList screen. | Point navigate.screen at a registered list screen. | `packages/framework/src/engine/boot-validator/named-filter-rules.ts` |
66
576
 
577
+ ## nav
578
+
579
+ | Rule | Summary | Fix | Source |
580
+ | --- | --- | --- | --- |
581
+ | <a id="nav-create-action-screen-unregistered"></a>`nav/create-action-screen-unregistered` | A nav createAction screen is a registered screen qualified name. | Use "<feature>:screen:<id>" pointing at an r.screen() declaration. | `packages/framework/src/engine/boot-validator/nav-rules.ts` |
582
+ | <a id="nav-create-action-target-count"></a>`nav/create-action-target-count` | A nav createAction sets exactly one of "screen" and "target". | Set either "screen" or "target" on the action. | `packages/framework/src/engine/boot-validator/nav-rules.ts` |
583
+ | <a id="nav-parent-cycle"></a>`nav/parent-cycle` | Nav entry parents form no cycle. | Change or remove the parent of one entry in the cycle. | `packages/framework/src/engine/boot-validator/nav-rules.ts` |
584
+ | <a id="nav-parent-unregistered"></a>`nav/parent-unregistered` | A nav entry's parent is a registered nav entry qualified name. | Use "<feature>:nav:<id>" pointing at a registered nav entry. | `packages/framework/src/engine/boot-validator/nav-rules.ts` |
585
+ | <a id="nav-screen-unregistered"></a>`nav/screen-unregistered` | A nav entry's screen is a registered screen qualified name. | Use "<feature>:screen:<id>" pointing at an r.screen() declaration. | `packages/framework/src/engine/boot-validator/nav-rules.ts` |
586
+ | <a id="nav-workspace-unregistered"></a>`nav/workspace-unregistered` | A nav entry self-assigns only to registered workspaces. | Use "<feature>:workspace:<id>" pointing at an r.workspace() declaration. | `packages/framework/src/engine/boot-validator/nav-rules.ts` |
587
+
588
+ ## ownership
589
+
590
+ | Rule | Summary | Fix | Source |
591
+ | --- | --- | --- | --- |
592
+ | <a id="ownership-unknown-claim"></a>`ownership/unknown-claim` | A from(...) ownership rule references only claims declared via r.claimKey. | Declare it via r.claimKey("...", { type: "..." }) in the owning feature. | `packages/framework/src/engine/boot-validator/ownership-rules.ts` |
593
+ | <a id="ownership-unknown-column"></a>`ownership/unknown-column` | A from(...) ownership rule references only columns that exist on the entity. | Use one of the entity's columns. | `packages/framework/src/engine/boot-validator/ownership-rules.ts` |
594
+ | <a id="ownership-unknown-role"></a>`ownership/unknown-role` | An access map names only roles that some feature defines. | Use a defined role name or declare the role. | `packages/framework/src/engine/boot-validator/ownership-rules.ts` |
595
+ | <a id="ownership-where-on-field-read"></a>`ownership/where-on-field-read` | A field-level read access map uses from(...) rules, not where(...). | Replace the where rule with a from rule on the field read path. | `packages/framework/src/engine/boot-validator/ownership-rules.ts` |
596
+ | <a id="ownership-where-on-write-path"></a>`ownership/where-on-write-path` | A write access map uses from(...) rules, not where(...), because where is read-only SQL. | Replace the where rule with a from rule on the write path. | `packages/framework/src/engine/boot-validator/ownership-rules.ts` |
597
+
598
+ ## parent-ref
599
+
600
+ | Rule | Summary | Fix | Source |
601
+ | --- | --- | --- | --- |
602
+ | <a id="parent-ref-allowed-type-has-parent-ref"></a>`parent-ref/allowed-type-has-parent-ref` | A parentRef host entity does not itself declare a parentRef (no recursive gating). | Remove the host from allowedTypes, or drop its own parentRef. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
603
+ | <a id="parent-ref-allowed-type-unregistered"></a>`parent-ref/allowed-type-unregistered` | parentRef.allowedTypes names only registered entities. | Remove the name from allowedTypes, or register the entity. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
604
+ | <a id="parent-ref-entity-id-field-unknown"></a>`parent-ref/entity-id-field-unknown` | parentRef.entityIdField names a declared field of the entity. | Point entityIdField at a real field on the entity. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
605
+ | <a id="parent-ref-entity-type-field-unknown"></a>`parent-ref/entity-type-field-unknown` | parentRef.entityTypeField names a declared field of the entity. | Point entityTypeField at a real field on the entity. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
606
+ | <a id="parent-ref-hand-written-query-handler"></a>`parent-ref/hand-written-query-handler` | Query handlers on an entity with parentRef carry the entity-convention brand, so the parent-ref read-gate applies. | Register the handler via defineEntityListHandler/defineEntityDetailHandler, or pass parentVisibility to the executor. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
607
+
67
608
  ## pii
68
609
 
69
610
  | Rule | Summary | Fix | Source |
@@ -80,6 +621,7 @@
80
621
  | <a id="pii-personal-of-owner-type"></a>`pii/personal-of-owner-type` | The owner field named by personal: { of } is a reference or text field. | Use a reference or text field as owner. | `packages/framework/src/engine/boot-validator/pii-retention-rules.ts` |
81
622
  | <a id="pii-personal-of-unknown-owner"></a>`pii/personal-of-unknown-owner` | The owner field named by personal: { of } exists on the entity. | Point personal.of at an existing field of the entity. | `packages/framework/src/engine/boot-validator/pii-retention-rules.ts` |
82
623
  | <a id="pii-plaintext-user-reference"></a>`pii/plaintext-user-reference` | A reference to the user entity is never plaintext. | Use the default reference field or personal: "ref" instead of personal: false. | `packages/framework/src/engine/boot-validator/pii-retention-rules.ts` |
624
+ | <a id="pii-record-owned-serial-id"></a>`pii/record-owned-serial-id` | A recordOwned (or whenAbsent: "self") field lives only on entities with idType "uuid", because forgetSubject validates the record id as a UUID. | Set idType: "uuid" on the entity, or give the field a different personal stance. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
83
625
  | <a id="pii-sensitive-searchable"></a>`pii/sensitive-searchable` | A sensitive field is never searchable. | Drop searchable, or add writeOnly to never return the value. | `packages/framework/src/engine/boot-validator/pii-retention-rules.ts` |
84
626
  | <a id="pii-sensitive-without-ciphertext"></a>`pii/sensitive-without-ciphertext` | A sensitive field is stored as ciphertext at rest. | Add a subject annotation or encrypted: true. | `packages/framework/src/engine/boot-validator/pii-retention-rules.ts` |
85
627
  | <a id="pii-subject-key-sortable"></a>`pii/subject-key-sortable` | A field with a subject-key annotation is not sortable, its column is ciphertext. | Drop sortable, use find: "exact" for equality lookups, or keep the field plaintext. | `packages/framework/src/engine/boot-validator/pii-retention-rules.ts` |
@@ -89,6 +631,98 @@
89
631
  | <a id="pii-write-only-non-text"></a>`pii/write-only-non-text` | writeOnly applies to text fields only. | Use a text field or remove writeOnly. | `packages/framework/src/engine/boot-validator/pii-retention-rules.ts` |
90
632
  | <a id="pii-write-only-without-sensitive"></a>`pii/write-only-without-sensitive` | A writeOnly field is also sensitive. | Declare the field with find: "secret". | `packages/framework/src/engine/boot-validator/pii-retention-rules.ts` |
91
633
 
634
+ ## projection
635
+
636
+ | Rule | Summary | Fix | Source |
637
+ | --- | --- | --- | --- |
638
+ | <a id="projection-per-instance-with-table"></a>`projection/per-instance-with-table` | A MultiStreamProjection with a table uses shared delivery. | Use delivery "shared", or drop the table for side-effect-only consumers. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
639
+
640
+ ## projection-detail
641
+
642
+ | Rule | Summary | Fix | Source |
643
+ | --- | --- | --- | --- |
644
+ | <a id="projection-detail-extension-contributes-to-form-submit"></a>`projection-detail/extension-contributes-to-form-submit` | A projectionDetail extension section does not set contributesToFormSubmit. | Omit contributesToFormSubmit and persist through the extension's own dispatcher writes. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
645
+ | <a id="projection-detail-extension-entity-name-missing"></a>`projection-detail/extension-entity-name-missing` | A projectionDetail extension section declares entityName. | Set entityName to the domain entity the extension persists against. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
646
+ | <a id="projection-detail-header-with-record-title-field"></a>`projection-detail/header-with-record-title-field` | A projectionDetail with a header sets no recordTitleField. | Drop recordTitleField; header.title names the record. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
647
+ | <a id="projection-detail-metric-label-missing"></a>`projection-detail/metric-label-missing` | Every metric has an i18n label key. | Set label on the metric. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
648
+ | <a id="projection-detail-metric-navigate-tab-unknown"></a>`projection-detail/metric-navigate-tab-unknown` | A metric navigate.tab names a section id of the screen. | Navigate to an existing section id or remove navigate.tab. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
649
+ | <a id="projection-detail-singleton-with-detail-for"></a>`projection-detail/singleton-with-detail-for` | A singleton projectionDetail sets no detailFor. | Remove detailFor, or declare an explicit edit action. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
650
+ | <a id="projection-detail-singleton-with-id-param"></a>`projection-detail/singleton-with-id-param` | A singleton projectionDetail sets no idParam. | Remove idParam. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
651
+ | <a id="projection-detail-status-format-without-status"></a>`projection-detail/status-format-without-status` | header.statusFormat is only set together with header.status. | Set header.status or remove statusFormat. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
652
+ | <a id="projection-detail-status-tone-invalid"></a>`projection-detail/status-tone-invalid` | header.statusTones values are known select option tones. | Use one of SELECT_OPTION_TONES. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
653
+ | <a id="projection-detail-subtitle-href-with-multi-part"></a>`projection-detail/subtitle-href-with-multi-part` | header.subtitleHref is only set with the string form of header.subtitle. | Use a single-field subtitle or remove subtitleHref. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
654
+ | <a id="projection-detail-subtitle-part-duplicate"></a>`projection-detail/subtitle-part-duplicate` | Each field appears once in header.subtitle. | List each field once. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
655
+ | <a id="projection-detail-subtitle-part-navigate-target-missing"></a>`projection-detail/subtitle-part-navigate-target-missing` | A header.subtitle part navigate names a screen or an entity. | Set screen or entity on the part's navigate. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
656
+ | <a id="projection-detail-tabs-section-groups-and-actions"></a>`projection-detail/tabs-section-groups-and-actions` | A tabs-mode section declares groups or actions, not both. | Move the actions onto one group's title, or drop groups. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
657
+ | <a id="projection-detail-wizard-related-list"></a>`projection-detail/wizard-related-list` | A wizard-mode layout has no relatedList section. | Remove mode: "wizard" or drop the relatedList section. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
658
+ | <a id="projection-detail-wizard-write-form"></a>`projection-detail/wizard-write-form` | A wizard-mode layout has no writeForm section. | Remove mode: "wizard" or drop the writeForm section. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
659
+ | <a id="projection-detail-write-form-field-defs-empty"></a>`projection-detail/write-form-field-defs-empty` | A writeForm section declares at least one fieldDefs entry. | Declare at least one field type. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
660
+ | <a id="projection-detail-write-form-field-without-def"></a>`projection-detail/write-form-field-without-def` | Every rendered writeForm field has a fieldDefs entry. | Add the field to fieldDefs. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
661
+ | <a id="projection-detail-write-form-fields-empty"></a>`projection-detail/write-form-fields-empty` | A writeForm section lists at least one field. | Drop the section or add fields. | `packages/framework/src/engine/boot-validator/screens-kind-projection-detail-rules.ts` |
662
+
663
+ ## query
664
+
665
+ | Rule | Summary | Fix | Source |
666
+ | --- | --- | --- | --- |
667
+ | <a id="query-list-source-output-without-rows"></a>`query/list-source-output-without-rows` | A query used as a list source has an outputSchema describing the paged envelope with a rows field. | Wrap the row schema in the { rows, nextCursor, total? } envelope. | `packages/framework/src/engine/boot-validator/query-rules.ts` |
668
+ | <a id="query-not-registered"></a>`query/not-registered` | A query reference on a screen names a registered query handler. | Check the QN spelling ("<feature>:query:<short>") and declare the handler via r.queryHandler(...). | `packages/framework/src/engine/boot-validator/query-rules.ts` |
669
+ | <a id="query-output-field-missing"></a>`query/output-field-missing` | A field a screen reads from a query result exists in the query's outputSchema. | Check the field name for a typo or add the field to the outputSchema. | `packages/framework/src/engine/boot-validator/query-rules.ts` |
670
+ | <a id="query-paged-output-without-rows"></a>`query/paged-output-without-rows` | A paged query handler's outputSchema describes the paged envelope with a rows field. | Wrap the row schema in the { rows, nextCursor, total? } envelope. | `packages/framework/src/engine/boot-validator/query-rules.ts` |
671
+ | <a id="query-singleton-load-requires-input"></a>`query/singleton-load-requires-input` | An actionForm singleton load binds a query that parses an empty payload. | Make the query's input fields optional. | `packages/framework/src/engine/boot-validator/query-rules.ts` |
672
+ | <a id="query-visible-when-id-param-unsupported"></a>`query/visible-when-id-param-unsupported` | visibleWhen.idParam is used only on projectionDetail screens. | Remove idParam or use a projectionDetail screen. | `packages/framework/src/engine/boot-validator/query-rules.ts` |
673
+ | <a id="query-visible-when-requires-input"></a>`query/visible-when-requires-input` | A visibleWhen query parses the payload the gate sends. | Make the query's input fields optional, use a query without required input, or for projectionDetail set visibleWhen.idParam. | `packages/framework/src/engine/boot-validator/query-rules.ts` |
674
+
675
+ ## rate-limit
676
+
677
+ | Rule | Summary | Fix | Source |
678
+ | --- | --- | --- | --- |
679
+ | <a id="rate-limit-additional-buckets-empty"></a>`rate-limit/additional-buckets-empty` | additionalRateLimits lists at least one bucket. | Declare a bucket or drop additionalRateLimits. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
680
+ | <a id="rate-limit-additional-payload-field-duplicate"></a>`rate-limit/additional-payload-field-duplicate` | additionalRateLimits has one entry per payloadField. | Keep one entry per payloadField. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
681
+ | <a id="rate-limit-additional-without-ip-bucket"></a>`rate-limit/additional-without-ip-bucket` | An anonymous handler with additionalRateLimits also has an ip-keyed rateLimit. | Set rateLimit: { per: "ip", ... } on the handler. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
682
+ | <a id="rate-limit-anonymous-user-bucket"></a>`rate-limit/anonymous-user-bucket` | A handler that allows anonymous callers does not bucket per user. | Use rateLimit.per "ip" or "ip+handler". | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
683
+ | <a id="rate-limit-anonymous-without-rate-limit"></a>`rate-limit/anonymous-without-rate-limit` | A handler that allows anonymous callers declares a rateLimit. | Set rateLimit: { per: "ip", ... } or { disabled: true, reason }. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
684
+ | <a id="rate-limit-bucket-list-empty"></a>`rate-limit/bucket-list-empty` | A rateLimit array lists at least one bucket. | Declare a bucket or drop the option. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
685
+ | <a id="rate-limit-bucket-per-duplicate"></a>`rate-limit/bucket-per-duplicate` | A rateLimit array has one entry per "per". | Keep one entry per "per". | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
686
+ | <a id="rate-limit-cost-on-anonymous-handler"></a>`rate-limit/cost-on-anonymous-handler` | rateLimitCost is declared only on authenticated handlers without an ip bucket. | Use a user/tenant bucket and drop "anonymous", or drop rateLimitCost. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
687
+ | <a id="rate-limit-cost-without-rate-limit"></a>`rate-limit/cost-without-rate-limit` | rateLimitCost requires an active rateLimit. | Declare rateLimit or drop rateLimitCost. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
688
+ | <a id="rate-limit-disabled-without-reason"></a>`rate-limit/disabled-without-reason` | A disabled rateLimit carries a non-empty reason. | Provide { disabled: true, reason: "..." }. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
689
+ | <a id="rate-limit-payload-field-unknown"></a>`rate-limit/payload-field-unknown` | Every additionalRateLimits payloadField is a field of the handler schema. | Name a field of the handler Zod object schema. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
690
+ | <a id="rate-limit-payload-limit-invalid"></a>`rate-limit/payload-limit-invalid` | An additionalRateLimits limit is a positive integer. | Set limit to a positive integer. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
691
+ | <a id="rate-limit-payload-window-invalid"></a>`rate-limit/payload-window-invalid` | An additionalRateLimits windowSeconds is a positive integer. | Set windowSeconds to a positive integer. | `packages/framework/src/engine/boot-validator/entity-handler-access-rules.ts` |
692
+
693
+ ## read-gate
694
+
695
+ | Rule | Summary | Fix | Source |
696
+ | --- | --- | --- | --- |
697
+ | <a id="read-gate-any-and-all-links"></a>`read-gate/any-and-all-links` | A readGate declares anyLink or allLinks, not both. | Pick one of anyLink and allLinks. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
698
+ | <a id="read-gate-file-owner-field-type"></a>`read-gate/file-owner-field-type` | readGate.fileOwner.field is a single file or image field. | Point fileOwner.field at a single file or image field. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
699
+ | <a id="read-gate-file-owner-needs-files-feature"></a>`read-gate/file-owner-needs-files-feature` | readGate.fileOwner requires the files feature to be mounted. | Mount the files feature. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
700
+ | <a id="read-gate-hand-written-reader"></a>`read-gate/hand-written-reader` | A gated entity's list and detail query handlers are entity-convention handlers, so they cannot bypass the readGate. | Register them via defineEntityListHandler/defineEntityDetailHandler. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
701
+ | <a id="read-gate-link-entity-unregistered"></a>`read-gate/link-entity-unregistered` | A readGate link names a registered entity. | Register the entity or fix the readGate link entity name. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
702
+ | <a id="read-gate-link-entity-without-parent-ref"></a>`read-gate/link-entity-without-parent-ref` | A readGate link entity declares a parentRef, because its host visibility is what the gate checks. | Declare a parentRef on the link entity or use another entity. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
703
+ | <a id="read-gate-link-field-unknown"></a>`read-gate/link-field-unknown` | A readGate link field is a field of the link entity. | Point the link field at a real field of the link entity. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
704
+ | <a id="read-gate-with-parent-ref"></a>`read-gate/with-parent-ref` | An entity with readGate does not also declare parentRef. | Drop readGate or parentRef. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
705
+
706
+ ## reference
707
+
708
+ | Rule | Summary | Fix | Source |
709
+ | --- | --- | --- | --- |
710
+ | <a id="reference-options-query-empty"></a>`reference/options-query-empty` | A reference optionsQuery is not empty. | Drop the property or name a query handler. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
711
+ | <a id="reference-options-query-unregistered"></a>`reference/options-query-unregistered` | A reference optionsQuery names a registered query handler. | Check the QN spelling and register the handler via r.queryHandler(...). | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
712
+ | <a id="reference-target-without-list-handler"></a>`reference/target-without-list-handler` | The referenced entity has a registered list query handler. | Register r.queryHandler(defineEntityListHandler(...)) in the target feature. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
713
+ | <a id="reference-unknown-entity"></a>`reference/unknown-entity` | A reference field targets an entity of the target feature. | Fix the entity name of the reference target. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
714
+ | <a id="reference-unknown-feature"></a>`reference/unknown-feature` | A reference field targets a registered feature. | Fix the feature prefix of the reference target. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
715
+ | <a id="reference-unknown-label-field"></a>`reference/unknown-label-field` | A reference labelField is a field of the referenced entity. | Name an existing field of the referenced entity. | `packages/framework/src/engine/boot-validator/entity-reference-embedded-rules.ts` |
716
+
717
+ ## related-list
718
+
719
+ | Rule | Summary | Fix | Source |
720
+ | --- | --- | --- | --- |
721
+ | <a id="related-list-expandable-row-bulk-actions"></a>`related-list/expandable-row-bulk-actions` | An entityList expandableRow declares no bulkActions. | Put bulkActions on the entityList screen itself. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
722
+ | <a id="related-list-expandable-row-grouping-choice"></a>`related-list/expandable-row-grouping-choice` | An expandableRow sets no table.grouping.userChoice or fields, it has no view menu. | Set a fixed table.grouping.field. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
723
+ | <a id="related-list-expandable-row-table-keys"></a>`related-list/expandable-row-table-keys` | An entityList expandableRow sets only table.grouping. | Put the other table options on the entityList screen itself. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
724
+ | <a id="related-list-group-by-removed"></a>`related-list/group-by-removed` | A relatedList section or expandableRow does not use the removed groupBy. | Use table.grouping and make the bound query accept aggregate. | `packages/framework/src/engine/boot-validator/list-query-rules.ts` |
725
+
92
726
  ## retention
93
727
 
94
728
  | Rule | Summary | Fix | Source |
@@ -99,7 +733,109 @@
99
733
 
100
734
  | Rule | Summary | Fix | Source |
101
735
  | --- | --- | --- | --- |
736
+ | <a id="screen-action-entity-id-unknown-field"></a>`screen/action-entity-id-unknown-field` | An action's entityId references an existing entity field or the id column. | Point entityId at a known field. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
737
+ | <a id="screen-action-field-function"></a>`screen/action-field-function` | Action payload, params, entityId and visible are declarative values, not functions. | Use the declarative DSL ({ pick }, { map }, field name, { field, eq }). | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
738
+ | <a id="screen-action-form-success-items-redirect"></a>`screen/action-form-success-items-redirect` | An actionForm shows successItems or redirects after submit, not both. | Drop redirect to show the successItems on the screen, or drop successItems to leave it. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
102
739
  | <a id="screen-action-icon"></a>`screen/action-icon` | Every screen action resolves to a registered icon. | Set icon to a registered NAV_ICONS key or use an action id that resolves one via the default icon map. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
740
+ | <a id="screen-action-unknown-field-ref"></a>`screen/action-unknown-field-ref` | Action payload and params extractors reference existing entity fields. | Name a known field in the pick/map extractor. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
741
+ | <a id="screen-action-visible-unknown-field"></a>`screen/action-visible-unknown-field` | An action's visible.field references an existing entity field. | Point visible.field at a known field. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
742
+ | <a id="screen-client-action-name"></a>`screen/client-action-name` | A clientAction names its handler as <feature>:<kebab-name>. | Use a name like "auth-email-password:request-password-reset". | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
743
+ | <a id="screen-columns-empty"></a>`screen/columns-empty` | A list screen declares at least one column. | Declare at least one column. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
744
+ | <a id="screen-custom-no-component"></a>`screen/custom-no-component` | A custom screen renderer declares a react or native component. | Set react or native on the renderer. | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
745
+ | <a id="screen-custom-write-qn-unregistered"></a>`screen/custom-write-qn-unregistered` | Every dispatcher.write QN in app source names a registered write handler. | Check the spelling against registered write handlers (<feature>:write:<handler>). | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
746
+ | <a id="screen-detail-for-duplicate"></a>`screen/detail-for-duplicate` | At most one screen declares detailFor for an entity. | Keep detailFor on one screen per entity. | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
747
+ | <a id="screen-detail-for-unknown-entity"></a>`screen/detail-for-unknown-entity` | detailFor names an entity a feature registers. | Set detailFor to a registered entity name or remove it. | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
748
+ | <a id="screen-drawer-target-not-action-form"></a>`screen/drawer-target-not-action-form` | A drawer action targets an actionForm screen. | Point screen at an actionForm screen, or use kind: navigate for a full-page target. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
749
+ | <a id="screen-drawer-target-unresolved"></a>`screen/drawer-target-unresolved` | A drawer action targets a registered screen of the same feature. | Point screen at a screen declared in the same feature. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
750
+ | <a id="screen-edit-field-condition-function"></a>`screen/edit-field-condition-function` | Edit field visible, readOnly and required are FieldConditions, not functions. | Use a FieldCondition (boolean or { field, eq/ne/in/notIn }). | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
751
+ | <a id="screen-entity-not-declared"></a>`screen/entity-not-declared` | A screen's entity is declared in its feature. | Declare the entity in this feature or fix the name. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
752
+ | <a id="screen-fallback-has-visible-when"></a>`screen/fallback-has-visible-when` | A fallback target has no visibleWhen of its own. | Point fallback at a screen without visibleWhen. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
753
+ | <a id="screen-fallback-map-empty"></a>`screen/fallback-map-empty` | A fallback map names at least one reason. | Set at least one fallback reason or use a screen id string. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
754
+ | <a id="screen-fallback-self"></a>`screen/fallback-self` | A screen's fallback points at a different screen. | Point fallback at a different screen. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
755
+ | <a id="screen-fallback-unknown-reason"></a>`screen/fallback-unknown-reason` | Fallback map keys are known fallback reasons. | Use only the documented fallback reasons. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
756
+ | <a id="screen-fallback-without-visible-when"></a>`screen/fallback-without-visible-when` | A screen with a fallback also declares visibleWhen. | Add visibleWhen or remove fallback. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
757
+ | <a id="screen-filter-in-needs-array"></a>`screen/filter-in-needs-array` | A filter with op in has an array value. | Pass an array as filter.value. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
758
+ | <a id="screen-header-action-row-click"></a>`screen/header-action-row-click` | Record header actions do not set rowClick, because a record screen has no row. | Remove rowClick. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
759
+ | <a id="screen-nav-target-unresolved"></a>`screen/nav-target-unresolved` | A redirect, cancelTarget, success link or fallback resolves to a registered screen. | Use the id of a screen in this feature or a fully-qualified <feature>:screen:<id>. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
760
+ | <a id="screen-navigate-entity-target-needs-entity-id"></a>`screen/navigate-entity-target-needs-entity-id` | An entity navigate-target on a non-entityList screen sets an explicit entityId. | Set entityId on the navigate action. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
761
+ | <a id="screen-navigate-entity-target-no-detail"></a>`screen/navigate-entity-target-no-detail` | An entity navigate-target has a screen declaring detailFor for that entity. | Add detailFor to a screen of the entity or navigate to a screen directly. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
762
+ | <a id="screen-navigate-params-dashboard-key-mismatch"></a>`screen/navigate-params-dashboard-key-mismatch` | Navigate params extract at least one key the target dashboard reads (filter id, time range id or record param). | Fix the params extractor to produce one of the dashboard's read keys, or remove it. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
763
+ | <a id="screen-navigate-params-dashboard-no-reader"></a>`screen/navigate-params-dashboard-no-reader` | A navigate action with params targets a dashboard that declares a filter, time range or record binding. | Remove the params extractor, or add a filter (or record binding) to the target dashboard. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
764
+ | <a id="screen-navigate-params-target-ignores-params"></a>`screen/navigate-params-target-ignores-params` | Navigate params only target screens that read URL search params as initial values (actionForm, secretMint, entityEdit-create). | Remove the params extractor or retarget to an actionForm, secretMint or cross-entity entityEdit-create screen. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
765
+ | <a id="screen-navigate-tab-target-not-tabbed"></a>`screen/navigate-tab-target-not-tabbed` | A navigate tab targets a projectionDetail screen with layout.mode tabs. | Remove the tab or navigate to a projectionDetail screen with layout.mode tabs. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
766
+ | <a id="screen-navigate-tab-target-unresolved"></a>`screen/navigate-tab-target-unresolved` | A navigate action with tab has a navigate-target that resolves to a screen. | Point the navigate-target at a registered screen. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
767
+ | <a id="screen-navigate-tab-unknown-section"></a>`screen/navigate-tab-unknown-section` | A navigate tab names a section id of the target screen. | Use one of the target screen's section ids. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
768
+ | <a id="screen-navigate-target-neither-screen-nor-entity"></a>`screen/navigate-target-neither-screen-nor-entity` | A navigate action sets exactly one of screen and entity. | Set screen or entity on the navigate action. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
769
+ | <a id="screen-navigate-target-screen-and-entity"></a>`screen/navigate-target-screen-and-entity` | A navigate action sets either screen or entity, not both. | Remove one of screen and entity. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
770
+ | <a id="screen-navigate-target-unresolved"></a>`screen/navigate-target-unresolved` | A navigate screen target resolves to a registered screen in any feature. | Use "<feature>:screen:<id>" of an existing screen. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
771
+ | <a id="screen-prefill-param-not-rendered"></a>`screen/prefill-param-not-rendered` | Prefill params only name fields the target form renders in its layout. | Add the field to the target layout or remove the param. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
772
+ | <a id="screen-prefill-param-sensitive-field"></a>`screen/prefill-param-sensitive-field` | Prefill params never name sensitive or password fields of the target form. | Remove the param or prefill a non-sensitive field. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
773
+ | <a id="screen-prefill-param-unknown-field"></a>`screen/prefill-param-unknown-field` | Prefill params only name fields the target form declares. | Name a field the target form declares, or remove the param. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
774
+ | <a id="screen-primary-action-unknown"></a>`screen/primary-action-unknown` | primaryAction and inlineActions name a declared action id or the default edit. | Use a declared action id, or "edit" when the screen sets detailFor. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
775
+ | <a id="screen-query-empty"></a>`screen/query-empty` | A screen or section query is a non-empty string. | Set query to a registered query name. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
776
+ | <a id="screen-redirect-id-from-empty"></a>`screen/redirect-id-from-empty` | A redirect object's idFrom is a non-empty string. | Name the success-payload field carrying the navigation id, or use the plain string redirect. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
777
+ | <a id="screen-redirect-id-from-on-idless-target"></a>`screen/redirect-id-from-on-idless-target` | A redirect idFrom only targets entityEdit or projectionDetail screens. | Use the plain string redirect form. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
778
+ | <a id="screen-redirect-id-from-whitespace"></a>`screen/redirect-id-from-whitespace` | A redirect idFrom has no leading or trailing whitespace. | Remove the whitespace from idFrom. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
779
+ | <a id="screen-redirect-on-list-row-action"></a>`screen/redirect-on-list-row-action` | List and related-list row actions do not set redirect. | Remove redirect; it is only honored on record actions. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
780
+ | <a id="screen-renderer-function"></a>`screen/renderer-function` | Field and column renderers are FormatSpecs, not functions. | Use a FormatSpec ({ format: "..." }). | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
781
+ | <a id="screen-row-click-at-most-one"></a>`screen/row-click-at-most-one` | At most one row-body click target (rowClick) is declared per list. | Mark at most one rowAction with rowClick: true. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
782
+ | <a id="screen-short-id-collision"></a>`screen/short-id-collision` | A screen short id is registered by at most one feature. | Give each screen a distinct id. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
783
+ | <a id="screen-submit-prefilled-hidden-required"></a>`screen/submit-prefilled-hidden-required` | With submitPrefilled, a hidden required field is passed in by a navigate action's params. | Add the field to the params of a navigate action targeting the screen, make it visible, or drop required. | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
784
+ | <a id="screen-submit-prefilled-unsupported"></a>`screen/submit-prefilled-unsupported` | Only actionForm and secretMint screens set submitPrefilled. | Remove submitPrefilled. | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
785
+ | <a id="screen-success-link-targets-record-screen"></a>`screen/success-link-targets-record-screen` | A success link without idFrom does not target a record screen. | Set idFrom to the success-payload field carrying the record id. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
786
+ | <a id="screen-unknown-field-reference"></a>`screen/unknown-field-reference` | A column or layout field names a field that exists on the screen's entity. | Name a field of the entity. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
787
+ | <a id="screen-unknown-type"></a>`screen/unknown-type` | A screen has a known type. | Use a supported screen type. | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
788
+ | <a id="screen-url-prefill-fields-set"></a>`screen/url-prefill-fields-set` | Screens do not set urlPrefillFields; buildAppSchema derives it. | Declare params on the navigating action instead. | `packages/framework/src/engine/boot-validator/screens-rules.ts` |
789
+ | <a id="screen-visible-when-empty"></a>`screen/visible-when-empty` | visibleWhen has a non-empty query and field. | Set both visibleWhen.query and visibleWhen.field. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
790
+ | <a id="screen-write-handler-unregistered"></a>`screen/write-handler-unregistered` | A handler reference resolves to a registered write handler. | Check the QN spelling ("<feature>:write:<short>") and that r.writeHandler(...) declares it. | `packages/framework/src/engine/boot-validator/screens-actions-rules.ts` |
791
+
792
+ ## secret-mint
793
+
794
+ | Rule | Summary | Fix | Source |
795
+ | --- | --- | --- | --- |
796
+ | <a id="secret-mint-reveal-field-duplicate"></a>`secret-mint/reveal-field-duplicate` | Each reveal field appears once. | Remove the duplicate entry. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
797
+ | <a id="secret-mint-reveal-field-label-empty"></a>`secret-mint/reveal-field-label-empty` | Every reveal.fields entry has a non-empty string label. | Set label to a non-empty string. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
798
+ | <a id="secret-mint-reveal-field-name-empty"></a>`secret-mint/reveal-field-name-empty` | Every reveal.fields entry has a non-empty string field. | Set field to a non-empty string. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
799
+ | <a id="secret-mint-reveal-fields-empty"></a>`secret-mint/reveal-fields-empty` | A secretMint screen reveals at least one field. | Declare at least one reveal field. | `packages/framework/src/engine/boot-validator/screens-kind-rules.ts` |
800
+
801
+ ## select
802
+
803
+ | Rule | Summary | Fix | Source |
804
+ | --- | --- | --- | --- |
805
+ | <a id="select-availability-query-unregistered"></a>`select/availability-query-unregistered` | optionsAvailabilityQuery names a registered query handler. | Check the QN spelling and register the handler via r.queryHandler(...). | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
806
+ | <a id="select-conditional-option-default"></a>`select/conditional-option-default` | The default option is not inside a conditionalOptions rule. | Move the default out of the rule. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
807
+ | <a id="select-conditional-option-duplicate"></a>`select/conditional-option-duplicate` | An option belongs to one conditionalOptions rule only. | Remove the option from one of the rules. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
808
+ | <a id="select-conditional-option-unknown"></a>`select/conditional-option-unknown` | conditionalOptions list only options of the select field. | List an option that exists in options. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
809
+ | <a id="select-conditional-options-rule-empty"></a>`select/conditional-options-rule-empty` | Every conditionalOptions rule lists at least one option. | Drop the rule or add options. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
810
+ | <a id="select-conditional-options-with-options-query"></a>`select/conditional-options-with-options-query` | A select field does not combine conditionalOptions with optionsQuery. | Remove either conditionalOptions or optionsQuery. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
811
+ | <a id="select-conditional-when-own-field"></a>`select/conditional-when-own-field` | A conditionalOptions when depends on a different field. | Make the condition depend on another field. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
812
+ | <a id="select-conditional-when-unknown-field"></a>`select/conditional-when-unknown-field` | A conditionalOptions when.field is a field of the entity. | Use an existing field of the entity. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
813
+ | <a id="select-conditional-when-value-not-option"></a>`select/conditional-when-value-not-option` | A conditionalOptions when compares only against options of the condition field. | Compare against an option of the condition field. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
814
+ | <a id="select-option-tone-invalid"></a>`select/option-tone-invalid` | Every select optionTones value is a known tone. | Use one of the listed tones. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
815
+ | <a id="select-options-query-unsupported"></a>`select/options-query-unsupported` | An entity select field has static options, no optionsQuery. | Use static options, or a reference field. | `packages/framework/src/engine/boot-validator/entity-select-image-rules.ts` |
816
+
817
+ ## tenant-lifecycle
818
+
819
+ | Rule | Summary | Fix | Source |
820
+ | --- | --- | --- | --- |
821
+ | <a id="tenant-lifecycle-destroy-function-missing"></a>`tenant-lifecycle/destroy-function-missing` | A tenant data or tenant resource extension registration provides its destroy function, otherwise tenant destroy fails at that stage. | Provide destroy (EXT_TENANT_DATA) or destroyTenant (tenant resource extensions) in the registration options. | `packages/bundled-features/src/tenant-lifecycle/boot-rules.ts` |
822
+ | <a id="tenant-lifecycle-tenant-subject-without-destroy-hook"></a>`tenant-lifecycle/tenant-subject-without-destroy-hook` | An entity with tenant-subject fields has an EXT_TENANT_DATA destroy hook, so tenant destroy erases its data. | Register r.useExtension(EXT_TENANT_DATA, "<entity>", { destroy }) or a documented no-op if crypto-shredding covers it. | `packages/bundled-features/src/tenant-lifecycle/boot-rules.ts` |
823
+
824
+ ## transfer
825
+
826
+ | Rule | Summary | Fix | Source |
827
+ | --- | --- | --- | --- |
828
+ | <a id="transfer-graph-too-deep"></a>`transfer/graph-too-deep` | The tenant-handover transfer graph is not deeper than the maximum depth. | Flatten the chain, or mark a reference field that should not move with its host `handover: "stay"`. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
829
+ | <a id="transfer-multiple-reference-field"></a>`transfer/multiple-reference-field` | A transferable entity declares no multiple reference field to another transferable entity, since the transfer graph cannot match jsonb array rows. | Model the link as a single reference on the owning side, or drop transferable from the entity. | `packages/framework/src/engine/boot-validator/entity-declaration-rules.ts` |
830
+
831
+ ## transition
832
+
833
+ | Rule | Summary | Fix | Source |
834
+ | --- | --- | --- | --- |
835
+ | <a id="transition-field-not-select"></a>`transition/field-not-select` | Transitions are declared for a select field. | Declare transitions on a select field. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
836
+ | <a id="transition-state-not-option"></a>`transition/state-not-option` | Every transition source state is an option of the select field. | Use an existing option. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
837
+ | <a id="transition-target-not-option"></a>`transition/target-not-option` | Every transition target is an option of the select field. | Use an existing option. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
838
+ | <a id="transition-unknown-field"></a>`transition/unknown-field` | Transitions are declared for a field of the entity. | Fix the field name. | `packages/framework/src/engine/boot-validator/entity-structure-rules.ts` |
103
839
 
104
840
  ## user-data-rights
105
841
 
@@ -108,3 +844,10 @@
108
844
  | <a id="user-data-rights-empty-hook"></a>`user-data-rights/empty-hook` | An EXT_USER_DATA registration declares at least one of an export or a delete hook. | Register at least one hook. | `packages/bundled-features/src/user-data-rights/boot-rules.ts` |
109
845
  | <a id="user-data-rights-export-without-delete"></a>`user-data-rights/export-without-delete` | An entity exported via EXT_USER_DATA also registers a delete hook. | Add a delete hook, or a documented no-op delete if erasure is handled elsewhere. | `packages/bundled-features/src/user-data-rights/boot-rules.ts` |
110
846
  | <a id="user-data-rights-missing-hook"></a>`user-data-rights/missing-hook` | An entity with user-subject fields registers an EXT_USER_DATA hook. | Register r.useExtension(EXT_USER_DATA, ...) for the entity, or a documented no-op hook if it is covered elsewhere. | `packages/bundled-features/src/user-data-rights/boot-rules.ts` |
847
+
848
+ ## workspace
849
+
850
+ | Rule | Summary | Fix | Source |
851
+ | --- | --- | --- | --- |
852
+ | <a id="workspace-multiple-defaults"></a>`workspace/multiple-defaults` | At most one workspace per app declares default: true. | Remove default: true from all but one workspace. | `packages/framework/src/engine/boot-validator/nav-rules.ts` |
853
+ | <a id="workspace-nav-unregistered"></a>`workspace/nav-unregistered` | A workspace references only registered nav entries. | Use "<feature>:nav:<id>" pointing at an r.nav() declaration. | `packages/framework/src/engine/boot-validator/nav-rules.ts` |