@cosmicdrift/kumiko-framework 0.412.0 → 0.413.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 (52) hide show
  1. package/agents/boot-rules.md +343 -0
  2. package/agents/examples/api-docs.md +79 -71
  3. package/agents/examples/golden-path.md +11 -11
  4. package/agents/examples/{contact.md → helpdesk.md} +31 -31
  5. package/agents/examples.md +1 -1
  6. package/agents/features-index.md +2 -2
  7. package/agents/features.md +16 -16
  8. package/dist/engine/boot-validator/boot-report.d.ts +3 -0
  9. package/dist/engine/boot-validator/boot-report.js +2 -2
  10. package/dist/engine/boot-validator/boot-rules.d.ts +570 -0
  11. package/dist/engine/boot-validator/boot-rules.js +20 -0
  12. package/dist/engine/boot-validator/definition-config-events-jobs-rules.d.ts +77 -0
  13. package/dist/engine/boot-validator/definition-config-events-jobs-rules.js +77 -0
  14. package/dist/engine/boot-validator/definition-events-rules.d.ts +42 -0
  15. package/dist/engine/boot-validator/definition-events-rules.js +42 -0
  16. package/dist/engine/boot-validator/definition-feature-rules.d.ts +42 -0
  17. package/dist/engine/boot-validator/definition-feature-rules.js +42 -0
  18. package/dist/engine/boot-validator/definition-field-factories-rules.d.ts +17 -0
  19. package/dist/engine/boot-validator/definition-field-factories-rules.js +17 -0
  20. package/dist/engine/boot-validator/definition-handlers-rules.d.ts +72 -0
  21. package/dist/engine/boot-validator/definition-handlers-rules.js +72 -0
  22. package/dist/engine/boot-validator/definition-ownership-from-rules.d.ts +27 -0
  23. package/dist/engine/boot-validator/definition-ownership-from-rules.js +27 -0
  24. package/dist/engine/boot-validator/definition-probes-rules.d.ts +47 -0
  25. package/dist/engine/boot-validator/definition-probes-rules.js +47 -0
  26. package/dist/engine/boot-validator/definition-role-assignment-rules.d.ts +27 -0
  27. package/dist/engine/boot-validator/definition-role-assignment-rules.js +27 -0
  28. package/dist/engine/boot-validator/definition-ui-extensions-rules.d.ts +197 -0
  29. package/dist/engine/boot-validator/definition-ui-extensions-rules.js +197 -0
  30. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +32 -0
  31. package/dist/engine/boot-validator/definition-webhook-events-rules.js +32 -0
  32. package/dist/engine/define-feature.js +26 -9
  33. package/dist/engine/define-handler.js +8 -4
  34. package/dist/engine/definition-violations.d.ts +14 -0
  35. package/dist/engine/definition-violations.js +71 -0
  36. package/dist/engine/entity-handlers.js +39 -13
  37. package/dist/engine/event-def.js +32 -12
  38. package/dist/engine/factories.js +16 -5
  39. package/dist/engine/feature-config-events-jobs.js +63 -27
  40. package/dist/engine/feature-entity-handlers.js +15 -6
  41. package/dist/engine/feature-probes.js +29 -9
  42. package/dist/engine/feature-ui-extensions.js +178 -92
  43. package/dist/engine/object-form.js +8 -2
  44. package/dist/engine/ownership.js +17 -5
  45. package/dist/engine/role-assignment.js +17 -5
  46. package/dist/engine/webhook-events.js +20 -6
  47. package/dist/files/file-routes.js +1 -1
  48. package/dist/schema-cli/shared.d.ts +11 -0
  49. package/dist/schema-cli/shared.js +37 -3
  50. package/dist/schema-cli/validate-command.js +10 -3
  51. package/package.json +3 -3
  52. package/src/changes.json +12 -0
@@ -16,10 +16,17 @@
16
16
  | Rule | Summary | Fix | Source |
17
17
  | --- | --- | --- | --- |
18
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` |
19
+ | <a id="api-exposes-called-twice"></a>`api/exposes-called-twice` | An API name is exposed once per feature. | Remove the duplicate r.exposesApi() call or rename it. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
19
20
  | <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` |
20
21
  | <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` |
21
22
  | <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` |
22
23
 
24
+ ## auth-email-password
25
+
26
+ | Rule | Summary | Fix | Source |
27
+ | --- | --- | --- | --- |
28
+ | <a id="auth-email-password-hmac-secret-too-short"></a>`auth-email-password/hmac-secret-too-short` | Each configured token hmacSecret is at least the minimum length. | Pass an hmacSecret of at least the minimum length. | `packages/bundled-features/src/auth-email-password/boot-rules.ts` |
29
+
23
30
  ## auth-foundation
24
31
 
25
32
  | Rule | Summary | Fix | Source |
@@ -30,6 +37,15 @@
30
37
  | <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
38
  | <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
39
 
40
+ ## billing-foundation
41
+
42
+ | Rule | Summary | Fix | Source |
43
+ | --- | --- | --- | --- |
44
+ | <a id="billing-foundation-base-url-invalid"></a>`billing-foundation/base-url-invalid` | baseUrl is a parseable absolute http or https URL. | Pass an absolute http(s) URL as baseUrl. | `packages/bundled-features/src/billing-foundation/boot-rules.ts` |
45
+ | <a id="billing-foundation-base-url-required"></a>`billing-foundation/base-url-required` | baseUrl is set whenever consumerProtection or a catalog is configured. | Pass baseUrl, checkout redirect URLs are built from it. | `packages/bundled-features/src/billing-foundation/boot-rules.ts` |
46
+ | <a id="billing-foundation-catalog-invalid"></a>`billing-foundation/catalog-invalid` | The catalog declares unique plans, root-relative paths, view roles and a valid contact card. | Fix the catalog option named in the error message. | `packages/bundled-features/src/billing-foundation/boot-rules.ts` |
47
+ | <a id="billing-foundation-consumer-protection-invalid"></a>`billing-foundation/consumer-protection-invalid` | consumerProtection options carry non-empty texts, a valid operator email, a valid termination scope and valid legal links. | Fix the consumerProtection option named in the error message. | `packages/bundled-features/src/billing-foundation/boot-rules.ts` |
48
+
33
49
  ## boot-check
34
50
 
35
51
  | Rule | Summary | Fix | Source |
@@ -47,6 +63,25 @@
47
63
  | <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
64
  | <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
65
 
66
+ ## cap-overview
67
+
68
+ | Rule | Summary | Fix | Source |
69
+ | --- | --- | --- | --- |
70
+ | <a id="cap-overview-empty-caps"></a>`cap-overview/empty-caps` | createCapOverviewFeature receives at least one cap. | Pass a non-empty caps list. | `packages/bundled-features/src/cap-overview/boot-rules.ts` |
71
+ | <a id="cap-overview-unknown-list-cap"></a>`cap-overview/unknown-list-cap` | listCaps only references cap ids declared in caps. | Use ids from caps in listCaps. | `packages/bundled-features/src/cap-overview/boot-rules.ts` |
72
+
73
+ ## claim
74
+
75
+ | Rule | Summary | Fix | Source |
76
+ | --- | --- | --- | --- |
77
+ | <a id="claim-key-duplicate"></a>`claim/key-duplicate` | Claim short names are unique per feature. | Rename one of the claims. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
78
+
79
+ ## config
80
+
81
+ | Rule | Summary | Fix | Source |
82
+ | --- | --- | --- | --- |
83
+ | <a id="config-single-key-needs-definition"></a>`config/single-key-needs-definition` | The single-key config() form receives a definition as second argument. | Pass the key definition as the second argument. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
84
+
50
85
  ## config-edit
51
86
 
52
87
  | Rule | Summary | Fix | Source |
@@ -94,6 +129,12 @@
94
129
  | <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
130
  | <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
131
 
132
+ ## content-collection
133
+
134
+ | Rule | Summary | Fix | Source |
135
+ | --- | --- | --- | --- |
136
+ | <a id="content-collection-id-duplicate"></a>`content-collection/id-duplicate` | Content collection ids are unique per feature. | Rename one of the collections. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
137
+
97
138
  ## dashboard
98
139
 
99
140
  | Rule | Summary | Fix | Source |
@@ -189,6 +230,13 @@
189
230
  | <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
231
  | <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
232
 
233
+ ## documents
234
+
235
+ | Rule | Summary | Fix | Source |
236
+ | --- | --- | --- | --- |
237
+ | <a id="documents-category-label-unknown-category"></a>`documents/category-label-unknown-category` | categoryLabels only names categories listed in categories. | Add the category to categories or drop its label. | `packages/bundled-features/src/documents/boot-rules.ts` |
238
+ | <a id="documents-negative-expiring-within-days"></a>`documents/negative-expiring-within-days` | expiringWithinDays is not negative. | Pass zero or a positive number. | `packages/bundled-features/src/documents/boot-rules.ts` |
239
+
192
240
  ## embedded-field
193
241
 
194
242
  | Rule | Summary | Fix | Source |
@@ -271,6 +319,29 @@
271
319
  | <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` |
272
320
  | <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` |
273
321
 
322
+ ## env-schema
323
+
324
+ | Rule | Summary | Fix | Source |
325
+ | --- | --- | --- | --- |
326
+ | <a id="env-schema-declared-twice"></a>`env-schema/declared-twice` | A feature calls r.envSchema() at most once. | Compose all env keys into one Zod object. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
327
+
328
+ ## event
329
+
330
+ | Rule | Summary | Fix | Source |
331
+ | --- | --- | --- | --- |
332
+ | <a id="event-migration-duplicate-step"></a>`event/migration-duplicate-step` | Each event migration step is declared once. | Remove the duplicate migration for that fromVersion. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
333
+ | <a id="event-migration-from-version-invalid"></a>`event/migration-from-version-invalid` | Event migrations start at fromVersion 1 or higher. | Set fromVersion to 1 or higher. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
334
+ | <a id="event-migration-rename-collision"></a>`event/migration-rename-collision` | A declarative migration maps at most one source to each rename target. | Rename only one source field to the target. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
335
+ | <a id="event-migration-step-size"></a>`event/migration-step-size` | Event migrations move exactly one version up. | Declare each version step separately with toVersion = fromVersion + 1. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
336
+ | <a id="event-pii-field-not-in-schema"></a>`event/pii-field-not-in-schema` | Event piiFields reference fields of the payload schema. | Name an existing payload field. | `packages/framework/src/engine/boot-validator/definition-events-rules.ts` |
337
+ | <a id="event-pii-owner-is-id"></a>`event/pii-owner-is-id` | Event PII fields do not use "id" as owner field. | Use personal: "self" for record-owned event fields. | `packages/framework/src/engine/boot-validator/definition-events-rules.ts` |
338
+ | <a id="event-pii-owner-not-string"></a>`event/pii-owner-not-string` | A PII owner field of an event payload is a string. | Use a string owner field or declare whenAbsent ("tenant", "self" or "plaintext"). | `packages/framework/src/engine/boot-validator/definition-events-rules.ts` |
339
+ | <a id="event-pii-owner-nullable"></a>`event/pii-owner-nullable` | A nullable PII owner field of an event declares whenAbsent. | Declare whenAbsent as "tenant", "self" or "plaintext". | `packages/framework/src/engine/boot-validator/definition-events-rules.ts` |
340
+ | <a id="event-pii-self-owner"></a>`event/pii-self-owner` | An event PII field is not its own owner field. | Point the owner at a separate user id field. | `packages/framework/src/engine/boot-validator/definition-events-rules.ts` |
341
+ | <a id="event-pii-stance-empty"></a>`event/pii-stance-empty` | An empty piiFields object is not a stance. | Use piiFields: "none" for payloads without personal data. | `packages/framework/src/engine/boot-validator/definition-events-rules.ts` |
342
+ | <a id="event-pii-stance-missing"></a>`event/pii-stance-missing` | Events declare an explicit PII stance. | Pass piiFields with owned fields or piiFields: "none". | `packages/framework/src/engine/boot-validator/definition-events-rules.ts` |
343
+ | <a id="event-version-invalid"></a>`event/version-invalid` | Event version is a positive integer. | Set version to an integer of 1 or higher. | `packages/framework/src/engine/boot-validator/definition-events-rules.ts` |
344
+
274
345
  ## extension
275
346
 
276
347
  | Rule | Summary | Fix | Source |
@@ -278,12 +349,36 @@
278
349
  | <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` |
279
350
  | <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` |
280
351
  | <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` |
352
+ | <a id="extension-use-escape-hatch-invalid"></a>`extension/use-escape-hatch-invalid` | r.useExtension() escapeHatch carries a valid reason and grants. | Pass escapeHatch as { reason: "<explanation>" } with valid grants. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
353
+
354
+ ## extension-selector
355
+
356
+ | Rule | Summary | Fix | Source |
357
+ | --- | --- | --- | --- |
358
+ | <a id="extension-selector-duplicate"></a>`extension-selector/duplicate` | Each extension point has at most one selector. | Declare one extensionSelector per extension. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
359
+ | <a id="extension-selector-panel-id-invalid"></a>`extension-selector/panel-id-invalid` | Extension selector panel ids are unique, non-empty and not the reserved selector id. | Give each panel its own id and avoid the reserved selector panel id. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
360
+ | <a id="extension-selector-panel-kind-unsupported"></a>`extension-selector/panel-kind-unsupported` | Extension selector panels are of kind custom or screen. | Use a panel of kind "custom" or "screen". | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
361
+ | <a id="extension-selector-screen-panel-label"></a>`extension-selector/screen-panel-label` | An extension selector screen panel sets no label. | Remove the label; the embedded screen carries its own title. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
281
362
 
282
363
  ## feature
283
364
 
284
365
  | Rule | Summary | Fix | Source |
285
366
  | --- | --- | --- | --- |
286
367
  | <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` |
368
+ | <a id="feature-dedupe-options-not-comparable"></a>`feature/dedupe-options-not-comparable` | dedupeOptions values are primitives or stable function references. | Replace nested objects in dedupeOptions with primitives or a module-level function reference. | `packages/framework/src/engine/boot-validator/definition-feature-rules.ts` |
369
+ | <a id="feature-describe-text-empty"></a>`feature/describe-text-empty` | r.describe() receives a non-empty string. | Pass a non-empty description text. | `packages/framework/src/engine/boot-validator/definition-feature-rules.ts` |
370
+ | <a id="feature-describe-twice"></a>`feature/describe-twice` | A feature calls r.describe() at most once. | Remove the second r.describe() call. | `packages/framework/src/engine/boot-validator/definition-feature-rules.ts` |
371
+ | <a id="feature-requires-needs-features"></a>`feature/requires-needs-features` | r.requires() receives { features: string[] }. | Pass the feature names as r.requires({ features: ["other-feature"] }). | `packages/framework/src/engine/boot-validator/definition-feature-rules.ts` |
372
+ | <a id="feature-toggleable-twice"></a>`feature/toggleable-twice` | A feature calls r.toggleable() at most once. | Remove the second r.toggleable() call. | `packages/framework/src/engine/boot-validator/definition-feature-rules.ts` |
373
+ | <a id="feature-ui-hints-twice"></a>`feature/ui-hints-twice` | A feature calls r.uiHints() at most once. | Merge all UI hints into a single r.uiHints() call. | `packages/framework/src/engine/boot-validator/definition-feature-rules.ts` |
374
+
375
+ ## field
376
+
377
+ | Rule | Summary | Fix | Source |
378
+ | --- | --- | --- | --- |
379
+ | <a id="field-decimal-precision-scale-invalid"></a>`field/decimal-precision-scale-invalid` | Decimal precision is at least 1 and scale lies between 0 and precision. | Use integers with 1 <= precision and 0 <= scale <= precision. | `packages/framework/src/engine/boot-validator/definition-field-factories-rules.ts` |
380
+ | <a id="field-personal-record-owner-when-absent"></a>`field/personal-record-owner-when-absent` | personal: { of: "id" } sets no whenAbsent. | Remove whenAbsent from the record-owned stance. | `packages/framework/src/engine/boot-validator/definition-field-factories-rules.ts` |
381
+ | <a id="field-user-reference-not-personal"></a>`field/user-reference-not-personal` | A reference to the user entity is personal data. | Drop personal: false or use { personal: "ref" }. | `packages/framework/src/engine/boot-validator/definition-field-factories-rules.ts` |
287
382
 
288
383
  ## field-condition
289
384
 
@@ -296,6 +391,12 @@
296
391
  | <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
392
  | <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
393
 
394
+ ## file-derivatives
395
+
396
+ | Rule | Summary | Fix | Source |
397
+ | --- | --- | --- | --- |
398
+ | <a id="file-derivatives-public-tenant-resolution-without-apex-resolver"></a>`file-derivatives/public-tenant-resolution-without-apex-resolver` | publicTenantResolution is only set together with resolveApexTenant. | Pass resolveApexTenant or drop publicTenantResolution. | `packages/bundled-features/src/file-derivatives/boot-rules.ts` |
399
+
299
400
  ## file-field
300
401
 
301
402
  | Rule | Summary | Fix | Source |
@@ -312,6 +413,12 @@
312
413
  | --- | --- | --- | --- |
313
414
  | <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
415
 
416
+ ## folders
417
+
418
+ | Rule | Summary | Fix | Source |
419
+ | --- | --- | --- | --- |
420
+ | <a id="folders-empty-parents-allowlist"></a>`folders/empty-parents-allowlist` | The parents allowlist is omitted or non-empty. | Omit parents or list at least one entity. | `packages/bundled-features/src/folders/boot-rules.ts` |
421
+
315
422
  ## form
316
423
 
317
424
  | Rule | Summary | Fix | Source |
@@ -401,11 +508,23 @@
401
508
  | <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` |
402
509
  | <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` |
403
510
  | <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` |
511
+ | <a id="handler-agent-risk-not-high"></a>`handler/agent-risk-not-high` | Handlers with irreversible or instruction-carrying effects declare agent.risk high. | Set agent.risk to "high". | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
404
512
  | <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` |
405
513
  | <a id="handler-any-signed-in-invalid"></a>`handler/any-signed-in-invalid` | access.anySignedIn is true when set and appears only next to the anonymous role, on endpoints that are public anyway. | Add "anonymous" to access.roles, or use { openToAll: { reason } } for every signed-in user without anonymous callers. | `packages/framework/src/engine/boot-validator/handler-declaration-rules.ts` |
514
+ | <a id="handler-crud-access-unresolved"></a>`handler/crud-access-unresolved` | r.crud() resolves an access rule for every verb it registers. | Set write.access, read.access or verbAccess.<verb> in the r.crud options. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
406
515
  | <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` |
516
+ | <a id="handler-escape-hatch-not-system-admin"></a>`handler/escape-hatch-not-system-admin` | A handler with escapeHatch is restricted to SystemAdmin. | Set access to { roles: [SystemAdmin] }. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
407
517
  | <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` |
518
+ | <a id="handler-exclude-fields-required-without-default"></a>`handler/exclude-fields-required-without-default` | excludeFields on create does not exclude required fields without a default. | Give the field a default or keep it writable. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
519
+ | <a id="handler-exclude-fields-totals-pair"></a>`handler/exclude-fields-totals-pair` | excludeFields leaves totalsMatch pairs together. | Keep both fields of the pair writable. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
520
+ | <a id="handler-exclude-fields-unknown-field"></a>`handler/exclude-fields-unknown-field` | excludeFields names fields of the entity. | Name an existing field or remove the entry. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
521
+ | <a id="handler-exclude-fields-verb-unsupported"></a>`handler/exclude-fields-verb-unsupported` | excludeFields is used on create and update handlers only. | Remove excludeFields from this handler. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
522
+ | <a id="handler-handler-and-perform-both"></a>`handler/handler-and-perform-both` | A write handler sets handler or perform, not both. | Keep either the free-form handler or the perform pipeline. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
523
+ | <a id="handler-inline-form-incomplete"></a>`handler/inline-form-incomplete` | The inline handler form provides schema, handler and options.access. | Pass schema, handler and options with access. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
408
524
  | <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` |
525
+ | <a id="handler-name-duplicate"></a>`handler/name-duplicate` | A handler name is registered once per feature. | Use a distinct name or drop the verb from r.crud. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
526
+ | <a id="handler-name-missing-entity"></a>`handler/name-missing-entity` | Entity handler names start with the entity name. | Put the entity name before the colon. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
527
+ | <a id="handler-name-pattern-invalid"></a>`handler/name-pattern-invalid` | Entity handler names use the "<entity>:<verb>" pattern. | Name the handler like "note:create". | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
409
528
  | <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` |
410
529
  | <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` |
411
530
  | <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` |
@@ -415,9 +534,11 @@
415
534
  | <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` |
416
535
  | <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` |
417
536
  | <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` |
537
+ | <a id="handler-restore-without-soft-delete"></a>`handler/restore-without-soft-delete` | Restore handlers exist only for entities with softDelete. | Declare softDelete: true on the entity or drop the restore verb. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
418
538
  | <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` |
419
539
  | <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` |
420
540
  | <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` |
541
+ | <a id="handler-verb-unknown"></a>`handler/verb-unknown` | Entity handler names end in a standard verb. | Use a standard verb or the explicit r.writeHandler / r.queryHandler form. | `packages/framework/src/engine/boot-validator/definition-handlers-rules.ts` |
421
542
 
422
543
  ## handler-schema
423
544
 
@@ -428,6 +549,40 @@
428
549
  | <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` |
429
550
  | <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` |
430
551
 
552
+ ## helpdesk
553
+
554
+ | Rule | Summary | Fix | Source |
555
+ | --- | --- | --- | --- |
556
+ | <a id="helpdesk-invalid-proof-of-work-bits"></a>`helpdesk/invalid-proof-of-work-bits` | spamProtection.proofOfWorkBits is an integer within the allowed range. | Use an integer inside the documented bounds. | `packages/bundled-features/src/helpdesk/boot-rules.ts` |
557
+
558
+ ## hook
559
+
560
+ | Rule | Summary | Fix | Source |
561
+ | --- | --- | --- | --- |
562
+ | <a id="hook-all-of-unsupported-type"></a>`hook/all-of-unsupported-type` | Hooks with target allOf are postSave, preDelete, postDelete or postQuery. | Use a supported hook type or a different target. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
563
+ | <a id="hook-escape-hatch-invalid"></a>`hook/escape-hatch-invalid` | A hook escapeHatch carries a valid reason and grants. | Fix the escapeHatch reason or grants as the message describes. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
564
+ | <a id="hook-type-unknown"></a>`hook/type-unknown` | Hooks use a known hook type. | Use a valid hook type; preQuery hooks were removed. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
565
+ | <a id="hook-validation-escape-hatch"></a>`hook/validation-escape-hatch` | Validation hooks declare no escapeHatch. | Remove escapeHatch from the validation hook. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
566
+
567
+ ## host-routing
568
+
569
+ | Rule | Summary | Fix | Source |
570
+ | --- | --- | --- | --- |
571
+ | <a id="host-routing-invalid-apex-anonymous-query-allowlist"></a>`host-routing/invalid-apex-anonymous-query-allowlist` | apexAnonymousQueryAllowlist keys are apex hostnames and the option is not combined with tenantBy path. | Use apex or www.<apex> keys and drop the option in path mode. | `packages/bundled-features/src/host-routing/boot-rules.ts` |
572
+ | <a id="host-routing-invalid-domain-or-prefix"></a>`host-routing/invalid-domain-or-prefix` | baseDomain and hosts keys are lowercase hostnames and tenantPathPrefix is a leading-slash path. | Fix the domain or prefix named in the error message. | `packages/bundled-features/src/host-routing/boot-rules.ts` |
573
+ | <a id="host-routing-invalid-locales"></a>`host-routing/invalid-locales` | Locales look like de or de-at and the default locale is not in prefixed. | Fix the locales option named in the error message. | `packages/bundled-features/src/host-routing/boot-rules.ts` |
574
+ | <a id="host-routing-invalid-redirect"></a>`host-routing/invalid-redirect` | Redirect rules use a path as from, a same-origin path or https URL as to, and a lowercase hostname as host. | Fix the redirect rule named in the error message. | `packages/bundled-features/src/host-routing/boot-rules.ts` |
575
+
576
+ ## http-route
577
+
578
+ | Rule | Summary | Fix | Source |
579
+ | --- | --- | --- | --- |
580
+ | <a id="http-route-anonymous-missing"></a>`http-route/anonymous-missing` | HTTP routes declare anonymous as true or false. | Set anonymous: true for public routes or false for session-authenticated ones. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
581
+ | <a id="http-route-duplicate"></a>`http-route/duplicate` | HTTP routes are unique per method and path within a feature. | Remove the duplicate route or change its method or path. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
582
+ | <a id="http-route-path-not-absolute"></a>`http-route/path-not-absolute` | HTTP route paths start with a slash. | Prefix the route path with "/". | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
583
+ | <a id="http-route-path-reserved"></a>`http-route/path-reserved` | HTTP route paths stay out of the reserved /api namespace. | Pick a path outside /api or use a query or write handler. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
584
+ | <a id="http-route-rate-limit-invalid"></a>`http-route/rate-limit-invalid` | HTTP route rateLimit has a positive integer limit and windowSeconds. | Set limit and windowSeconds to positive integers. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
585
+
431
586
  ## i18n
432
587
 
433
588
  | Rule | Summary | Fix | Source |
@@ -450,6 +605,29 @@
450
605
  | <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` |
451
606
  | <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` |
452
607
 
608
+ ## job
609
+
610
+ | Rule | Summary | Fix | Source |
611
+ | --- | --- | --- | --- |
612
+ | <a id="job-cron-timezone-invalid"></a>`job/cron-timezone-invalid` | A cron trigger tz is an IANA time zone name. | Use a zone name such as "Europe/Berlin". | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
613
+ | <a id="job-escape-hatch-invalid"></a>`job/escape-hatch-invalid` | A job escapeHatch carries a valid reason and grants. | Fix the escapeHatch reason or grants as the message describes. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
614
+ | <a id="job-maintenance-trigger-invalid"></a>`job/maintenance-trigger-invalid` | A job maintenance trigger has the value true. | Use trigger { maintenance: true }. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
615
+ | <a id="job-wakes-sleeping-app-invalid"></a>`job/wakes-sleeping-app-invalid` | wakesSleepingApp is false and only on cron or maintenance triggers. | Use wakesSleepingApp: false on a cron or maintenance trigger, or omit it. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
616
+
617
+ ## jobs
618
+
619
+ | Rule | Summary | Fix | Source |
620
+ | --- | --- | --- | --- |
621
+ | <a id="jobs-anonymous-read-role"></a>`jobs/anonymous-read-role` | The jobs readRoles option does not contain anonymous. | Remove anonymous from readRoles. | `packages/bundled-features/src/jobs/boot-rules.ts` |
622
+
623
+ ## legal-pages
624
+
625
+ | Rule | Summary | Fix | Source |
626
+ | --- | --- | --- | --- |
627
+ | <a id="legal-pages-duplicate-route-path"></a>`legal-pages/duplicate-route-path` | Legal page route paths are unique. | Remove or rename the duplicate route. | `packages/bundled-features/src/legal-pages/boot-rules.ts` |
628
+ | <a id="legal-pages-invalid-route"></a>`legal-pages/invalid-route` | Legal page routes declare path, slug and lang, and the path starts with a slash. | Fix the route named in the error message. | `packages/bundled-features/src/legal-pages/boot-rules.ts` |
629
+ | <a id="legal-pages-routes-without-required-blocks"></a>`legal-pages/routes-without-required-blocks` | Custom routes that miss the default required blocks pass requiredBlocks explicitly. | Pass requiredBlocks (or an empty array) alongside custom routes. | `packages/bundled-features/src/legal-pages/boot-rules.ts` |
630
+
453
631
  ## list
454
632
 
455
633
  | Rule | Summary | Fix | Source |
@@ -556,6 +734,19 @@
556
734
  | <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` |
557
735
  | <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` |
558
736
 
737
+ ## metric
738
+
739
+ | Rule | Summary | Fix | Source |
740
+ | --- | --- | --- | --- |
741
+ | <a id="metric-name-duplicate"></a>`metric/name-duplicate` | Metric names are unique per feature. | Rename one of the metrics. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
742
+
743
+ ## metrics
744
+
745
+ | Rule | Summary | Fix | Source |
746
+ | --- | --- | --- | --- |
747
+ | <a id="metrics-duplicate-metric-id"></a>`metrics/duplicate-metric-id` | Metric ids passed to the metrics factory are unique. | Rename one of the metrics. | `packages/bundled-features/src/metrics/boot-rules.ts` |
748
+ | <a id="metrics-invalid-metric"></a>`metrics/invalid-metric` | Each metric passed to the metrics factory has a kebab-case id and a valid definition. | Fix the metric named in the error message. | `packages/bundled-features/src/metrics/boot-rules.ts` |
749
+
559
750
  ## multi-select
560
751
 
561
752
  | Rule | Summary | Fix | Source |
@@ -584,15 +775,28 @@
584
775
  | --- | --- | --- | --- |
585
776
  | <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` |
586
777
  | <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` |
778
+ | <a id="nav-id-duplicate"></a>`nav/id-duplicate` | Nav ids are unique per feature. | Remove the standalone r.nav() call or the screen's inline nav. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
779
+ | <a id="nav-id-not-kebab"></a>`nav/id-not-kebab` | Nav ids are kebab-case. | Rename the nav id to lowercase letters, digits and dashes, starting with a letter. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
587
780
  | <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` |
588
781
  | <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` |
589
782
  | <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` |
590
783
  | <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` |
591
784
 
785
+ ## notes-history
786
+
787
+ | Rule | Summary | Fix | Source |
788
+ | --- | --- | --- | --- |
789
+ | <a id="notes-history-empty-parents-allowlist"></a>`notes-history/empty-parents-allowlist` | The parents allowlist is omitted or non-empty. | Omit parents or list at least one entity. | `packages/bundled-features/src/notes-history/boot-rules.ts` |
790
+
592
791
  ## ownership
593
792
 
594
793
  | Rule | Summary | Fix | Source |
595
794
  | --- | --- | --- | --- |
795
+ | <a id="ownership-from-claim-ref-invalid"></a>`ownership/from-claim-ref-invalid` | from() claim refs are "claim:<feature>:<shortName>". | Add the feature and short name to the ref. | `packages/framework/src/engine/boot-validator/definition-ownership-from-rules.ts` |
796
+ | <a id="ownership-from-prefix-unsupported"></a>`ownership/from-prefix-unsupported` | from() refs start with "user" or "claim". | Use a supported prefix. | `packages/framework/src/engine/boot-validator/definition-ownership-from-rules.ts` |
797
+ | <a id="ownership-from-ref-without-colon"></a>`ownership/from-ref-without-colon` | from() refs have the form "user:<field>" or "claim:<feature>:<key>". | Add the prefix and colon to the ref. | `packages/framework/src/engine/boot-validator/definition-ownership-from-rules.ts` |
798
+ | <a id="ownership-from-user-column-missing"></a>`ownership/from-user-column-missing` | from() with a user ref names the column explicitly. | Pass a column, e.g. from("user:id", "assigneeId"). | `packages/framework/src/engine/boot-validator/definition-ownership-from-rules.ts` |
799
+ | <a id="ownership-from-user-ref-unsupported"></a>`ownership/from-user-ref-unsupported` | from() user refs are "user:id" or "user:tenantId". | Use one of the two supported user refs. | `packages/framework/src/engine/boot-validator/definition-ownership-from-rules.ts` |
596
800
  | <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` |
597
801
  | <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` |
598
802
  | <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` |
@@ -609,6 +813,12 @@
609
813
  | <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` |
610
814
  | <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` |
611
815
 
816
+ ## personal-access-tokens
817
+
818
+ | Rule | Summary | Fix | Source |
819
+ | --- | --- | --- | --- |
820
+ | <a id="personal-access-tokens-scope-event-without-contract"></a>`personal-access-tokens/scope-event-without-contract` | Events listed in PAT scopes have a public webhook contract. | Declare the event with r.defineWebhookEvent or opt the entity into webhookEvents. | `packages/bundled-features/src/personal-access-tokens/boot-rules.ts` |
821
+
612
822
  ## pii
613
823
 
614
824
  | Rule | Summary | Fix | Source |
@@ -635,10 +845,36 @@
635
845
  | <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` |
636
846
  | <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` |
637
847
 
848
+ ## presence
849
+
850
+ | Rule | Summary | Fix | Source |
851
+ | --- | --- | --- | --- |
852
+ | <a id="presence-invalid-ttl-seconds"></a>`presence/invalid-ttl-seconds` | The presence ttlSeconds option is a positive number. | Pass a positive ttlSeconds. | `packages/bundled-features/src/presence/boot-rules.ts` |
853
+
854
+ ## probe
855
+
856
+ | Rule | Summary | Fix | Source |
857
+ | --- | --- | --- | --- |
858
+ | <a id="probe-cost-invalid"></a>`probe/cost-invalid` | Probe cost is free or paid. | Set cost to a listed value. | `packages/framework/src/engine/boot-validator/definition-probes-rules.ts` |
859
+ | <a id="probe-duplicate"></a>`probe/duplicate` | Probe names are unique per feature. | Rename one of the probes. | `packages/framework/src/engine/boot-validator/definition-probes-rules.ts` |
860
+ | <a id="probe-i18n-key-empty"></a>`probe/i18n-key-empty` | Probe area and label are non-empty i18n keys. | Set area and label to i18n keys. | `packages/framework/src/engine/boot-validator/definition-probes-rules.ts` |
861
+ | <a id="probe-name-empty"></a>`probe/name-empty` | A probe name is a non-empty string. | Give the probe a name. | `packages/framework/src/engine/boot-validator/definition-probes-rules.ts` |
862
+ | <a id="probe-name-not-kebab"></a>`probe/name-not-kebab` | Probe names are kebab-case. | Rename the probe to lowercase letters, digits and dashes. | `packages/framework/src/engine/boot-validator/definition-probes-rules.ts` |
863
+ | <a id="probe-run-not-function"></a>`probe/run-not-function` | Probe run is a function. | Pass a run function. | `packages/framework/src/engine/boot-validator/definition-probes-rules.ts` |
864
+ | <a id="probe-scope-invalid"></a>`probe/scope-invalid` | Probe scope is tenant or system. | Set scope to a listed value. | `packages/framework/src/engine/boot-validator/definition-probes-rules.ts` |
865
+ | <a id="probe-targets-not-function"></a>`probe/targets-not-function` | Probe targets is a function when set. | Pass a function or omit targets. | `packages/framework/src/engine/boot-validator/definition-probes-rules.ts` |
866
+ | <a id="probe-timeout-invalid"></a>`probe/timeout-invalid` | Probe timeoutMs is greater than zero. | Set timeoutMs above zero or omit it. | `packages/framework/src/engine/boot-validator/definition-probes-rules.ts` |
867
+
638
868
  ## projection
639
869
 
640
870
  | Rule | Summary | Fix | Source |
641
871
  | --- | --- | --- | --- |
872
+ | <a id="projection-extend-without-apply"></a>`projection/extend-without-apply` | extendEntityProjection declares at least one apply handler. | Declare at least one event type to apply. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
873
+ | <a id="projection-multi-stream-name-duplicate"></a>`projection/multi-stream-name-duplicate` | r.projection and r.multiStreamProjection share one name space per feature. | Pick a unique short name. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
874
+ | <a id="projection-multi-stream-name-not-kebab"></a>`projection/multi-stream-name-not-kebab` | Multi-stream projection names are kebab-case. | Rename the projection to lowercase letters, digits and dashes. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
875
+ | <a id="projection-multi-stream-without-apply"></a>`projection/multi-stream-without-apply` | A multi-stream projection declares at least one apply handler. | Declare at least one event type the projection reacts to. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
876
+ | <a id="projection-name-duplicate"></a>`projection/name-duplicate` | Projection names are unique per feature. | Rename one of the projections. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
877
+ | <a id="projection-name-not-kebab"></a>`projection/name-not-kebab` | Projection names are kebab-case. | Rename the projection to lowercase letters, digits and dashes. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
642
878
  | <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` |
643
879
 
644
880
  ## projection-detail
@@ -708,6 +944,13 @@
708
944
  | <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` |
709
945
  | <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` |
710
946
 
947
+ ## readiness
948
+
949
+ | Rule | Summary | Fix | Source |
950
+ | --- | --- | --- | --- |
951
+ | <a id="readiness-probe-fix-screen-unknown"></a>`readiness/probe-fix-screen-unknown` | A probe fixScreen names a screen of a mounted feature. | Use a <feature>:screen:<id> qualified name of a mounted screen. | `packages/bundled-features/src/readiness/boot-rules.ts` |
952
+ | <a id="readiness-probe-translation-missing"></a>`readiness/probe-translation-missing` | Probe area and label keys are defined by a mounted feature. | Add the key via r.translations(...). | `packages/bundled-features/src/readiness/boot-rules.ts` |
953
+
711
954
  ## reference
712
955
 
713
956
  | Rule | Summary | Fix | Source |
@@ -719,6 +962,13 @@
719
962
  | <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` |
720
963
  | <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` |
721
964
 
965
+ ## registrar
966
+
967
+ | Rule | Summary | Fix | Source |
968
+ | --- | --- | --- | --- |
969
+ | <a id="registrar-argument-missing"></a>`registrar/argument-missing` | Every registrar method receives all its required arguments. | Pass the missing argument named in the message. | `packages/framework/src/engine/boot-validator/definition-feature-rules.ts` |
970
+ | <a id="registrar-options-object-required"></a>`registrar/options-object-required` | Object-form registrar methods take one options object. | Pass a single options object such as r.entity({ name: ... }). | `packages/framework/src/engine/boot-validator/definition-feature-rules.ts` |
971
+
722
972
  ## related-list
723
973
 
724
974
  | Rule | Summary | Fix | Source |
@@ -734,6 +984,16 @@
734
984
  | --- | --- | --- | --- |
735
985
  | <a id="retention-unknown-reference"></a>`retention/unknown-reference` | retention.reference names an existing field or a framework timestamp. | Point retention.reference at an existing field or a framework-managed timestamp. | `packages/framework/src/engine/boot-validator/pii-retention-rules.ts` |
736
986
 
987
+ ## role
988
+
989
+ | Rule | Summary | Fix | Source |
990
+ | --- | --- | --- | --- |
991
+ | <a id="role-assignable-built-in"></a>`role/assignable-built-in` | Assignable roles are not built-in roles. | Pick a different role name. | `packages/framework/src/engine/boot-validator/definition-role-assignment-rules.ts` |
992
+ | <a id="role-assignable-from-conflict"></a>`role/assignable-from-conflict` | A role is declared with one assignableFrom value. | Declare the same assignableFrom everywhere or declare it once. | `packages/framework/src/engine/boot-validator/definition-role-assignment-rules.ts` |
993
+ | <a id="role-assignable-from-invalid"></a>`role/assignable-from-invalid` | assignableFrom is one of the allowed roles. | Use a role from the list in the message. | `packages/framework/src/engine/boot-validator/definition-role-assignment-rules.ts` |
994
+ | <a id="role-assignable-name-empty"></a>`role/assignable-name-empty` | Assignable role names are non-empty. | Give the role a name. | `packages/framework/src/engine/boot-validator/definition-role-assignment-rules.ts` |
995
+ | <a id="role-assignable-reserved"></a>`role/assignable-reserved` | Assignable roles are not reserved platform roles. | Pick a different role name. | `packages/framework/src/engine/boot-validator/definition-role-assignment-rules.ts` |
996
+
737
997
  ## screen
738
998
 
739
999
  | Rule | Summary | Fix | Source |
@@ -761,6 +1021,8 @@
761
1021
  | <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` |
762
1022
  | <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` |
763
1023
  | <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` |
1024
+ | <a id="screen-id-duplicate"></a>`screen/id-duplicate` | Screen ids are unique per feature. | Rename one of the screens. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1025
+ | <a id="screen-id-not-kebab"></a>`screen/id-not-kebab` | Screen ids are kebab-case. | Rename the screen id to lowercase letters, digits and dashes. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
764
1026
  | <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` |
765
1027
  | <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` |
766
1028
  | <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` |
@@ -794,6 +1056,14 @@
794
1056
  | <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` |
795
1057
  | <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` |
796
1058
 
1059
+ ## secret
1060
+
1061
+ | Rule | Summary | Fix | Source |
1062
+ | --- | --- | --- | --- |
1063
+ | <a id="secret-key-duplicate"></a>`secret/key-duplicate` | Secret key names are unique per feature. | Rename one of the secrets. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
1064
+ | <a id="secret-namespace-duplicate"></a>`secret/namespace-duplicate` | Secret namespace names are unique per feature. | Rename one of the namespaces. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
1065
+ | <a id="secret-write-roles-empty"></a>`secret/write-roles-empty` | A secret or namespace writeRoles list is non-empty. | Add roles or omit writeRoles to use the secrets handler access. | `packages/framework/src/engine/boot-validator/definition-config-events-jobs-rules.ts` |
1066
+
797
1067
  ## secret-mint
798
1068
 
799
1069
  | Rule | Summary | Fix | Source |
@@ -819,6 +1089,50 @@
819
1089
  | <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` |
820
1090
  | <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` |
821
1091
 
1092
+ ## shared
1093
+
1094
+ | Rule | Summary | Fix | Source |
1095
+ | --- | --- | --- | --- |
1096
+ | <a id="shared-where-rule-in-ownership-write"></a>`shared/where-rule-in-ownership-write` | ownership.write of a bundled-feature factory contains no where rule. | Drop the where rule from ownership.write; it only applies on the read path. | `packages/bundled-features/src/shared/boot-rules.ts` |
1097
+
1098
+ ## store-table
1099
+
1100
+ | Rule | Summary | Fix | Source |
1101
+ | --- | --- | --- | --- |
1102
+ | <a id="store-table-duplicate"></a>`store-table/duplicate` | Store table names are unique per feature. | Rename one of the store tables. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1103
+ | <a id="store-table-meta-not-unmanaged"></a>`store-table/meta-not-unmanaged` | r.storeTable() receives table meta with source unmanaged. | Build the meta with defineUnmanagedTable() or source: "unmanaged". | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1104
+ | <a id="store-table-name-invalid"></a>`store-table/name-invalid` | Store table names are valid lowercase identifiers. | Use lowercase letters, digits and underscores, starting with a letter. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1105
+ | <a id="store-table-read-prefix-reserved"></a>`store-table/read-prefix-reserved` | Store table names do not use the read_ prefix. | Pick an unprefixed name or a distinct prefix such as store_. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1106
+ | <a id="store-table-reason-missing"></a>`store-table/reason-missing` | r.storeTable() declares a non-empty options.reason. | Add a reason justifying the audit-trail bypass or declare the data via r.entity(). | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1107
+
1108
+ ## subscription-mollie
1109
+
1110
+ | Rule | Summary | Fix | Source |
1111
+ | --- | --- | --- | --- |
1112
+ | <a id="subscription-mollie-empty-api-key"></a>`subscription-mollie/empty-api-key` | The Mollie provider receives a non-empty apiKey. | Set MOLLIE_API_KEY before mounting. | `packages/bundled-features/src/subscription-mollie/boot-rules.ts` |
1113
+ | <a id="subscription-mollie-empty-webhook-url"></a>`subscription-mollie/empty-webhook-url` | The Mollie provider receives a non-empty webhookUrl. | Pass the foundation webhook URL Mollie sends events to. | `packages/bundled-features/src/subscription-mollie/boot-rules.ts` |
1114
+ | <a id="subscription-mollie-price-map-drift"></a>`subscription-mollie/price-map-drift` | priceToTier and priceToConfig declare the same price ids. | Make both maps list the same price ids. | `packages/bundled-features/src/subscription-mollie/boot-rules.ts` |
1115
+
1116
+ ## tags
1117
+
1118
+ | Rule | Summary | Fix | Source |
1119
+ | --- | --- | --- | --- |
1120
+ | <a id="tags-empty-parents-allowlist"></a>`tags/empty-parents-allowlist` | The parents allowlist is omitted or non-empty. | Omit parents or list at least one entity. | `packages/bundled-features/src/tags/boot-rules.ts` |
1121
+
1122
+ ## template-resolver
1123
+
1124
+ | Rule | Summary | Fix | Source |
1125
+ | --- | --- | --- | --- |
1126
+ | <a id="template-resolver-collection-refused-kind"></a>`template-resolver/collection-refused-kind` | Collections only use kinds that collections may write. | Pick an allowed collection kind. | `packages/bundled-features/src/template-resolver/boot-rules.ts` |
1127
+ | <a id="template-resolver-tenant-editable-duplicate"></a>`template-resolver/tenant-editable-duplicate` | tenantEditable lists each kind and slug once. | Remove the duplicate entry. | `packages/bundled-features/src/template-resolver/boot-rules.ts` |
1128
+ | <a id="template-resolver-tenant-editable-invalid-entry"></a>`template-resolver/tenant-editable-invalid-entry` | Each tenantEditable entry has a non-empty slug and at least one access role. | Give the entry a slug and roles. | `packages/bundled-features/src/template-resolver/boot-rules.ts` |
1129
+
1130
+ ## tenant
1131
+
1132
+ | Rule | Summary | Fix | Source |
1133
+ | --- | --- | --- | --- |
1134
+ | <a id="tenant-assignable-role-missing-from-screens"></a>`tenant/assignable-role-missing-from-screens` | Every assignable app role is present in the tenant screens' options. | Pass assignableAppRoles: collectAssignableAppRoles(appFeatures) to createTenantFeature. | `packages/bundled-features/src/tenant/boot-rules.ts` |
1135
+
822
1136
  ## tenant-lifecycle
823
1137
 
824
1138
  | Rule | Summary | Fix | Source |
@@ -842,6 +1156,12 @@
842
1156
  | <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` |
843
1157
  | <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` |
844
1158
 
1159
+ ## tree-actions
1160
+
1161
+ | Rule | Summary | Fix | Source |
1162
+ | --- | --- | --- | --- |
1163
+ | <a id="tree-actions-declared-twice"></a>`tree-actions/declared-twice` | A feature calls r.treeActions() at most once. | Merge the tree actions into a single r.treeActions() call. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1164
+
845
1165
  ## user-data-rights
846
1166
 
847
1167
  | Rule | Summary | Fix | Source |
@@ -850,9 +1170,32 @@
850
1170
  | <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` |
851
1171
  | <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` |
852
1172
 
1173
+ ## webhook-event
1174
+
1175
+ | Rule | Summary | Fix | Source |
1176
+ | --- | --- | --- | --- |
1177
+ | <a id="webhook-event-description-empty"></a>`webhook-event/description-empty` | Webhook events carry a non-empty description sentence. | Add a description. | `packages/framework/src/engine/boot-validator/definition-webhook-events-rules.ts` |
1178
+ | <a id="webhook-event-duplicate"></a>`webhook-event/duplicate` | Webhook event names are unique per feature. | Rename one of the events. | `packages/framework/src/engine/boot-validator/definition-webhook-events-rules.ts` |
1179
+ | <a id="webhook-event-name-not-kebab"></a>`webhook-event/name-not-kebab` | Webhook event names are kebab-case. | Rename the event to lowercase letters, digits and dashes. | `packages/framework/src/engine/boot-validator/definition-webhook-events-rules.ts` |
1180
+ | <a id="webhook-event-payload-not-zod-object"></a>`webhook-event/payload-not-zod-object` | Webhook event payloads are Zod object schemas. | Pass z.object({ ... }) as payload. | `packages/framework/src/engine/boot-validator/definition-webhook-events-rules.ts` |
1181
+ | <a id="webhook-event-version-invalid"></a>`webhook-event/version-invalid` | Webhook event version is a positive integer. | Set version to an integer of 1 or higher. | `packages/framework/src/engine/boot-validator/definition-webhook-events-rules.ts` |
1182
+ | <a id="webhook-event-wire-name-empty"></a>`webhook-event/wire-name-empty` | Webhook event wireName is a non-empty string when set. | Set a wireName or omit it. | `packages/framework/src/engine/boot-validator/definition-webhook-events-rules.ts` |
1183
+
1184
+ ## websocket-route
1185
+
1186
+ | Rule | Summary | Fix | Source |
1187
+ | --- | --- | --- | --- |
1188
+ | <a id="websocket-route-duplicate"></a>`websocket-route/duplicate` | WebSocket route paths are unique per feature. | Remove the duplicate route or change its path. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1189
+ | <a id="websocket-route-max-connections-invalid"></a>`websocket-route/max-connections-invalid` | WebSocket maxConnectionsPerUser is an integer within the allowed range. | Set maxConnectionsPerUser to an integer within the range in the message. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1190
+ | <a id="websocket-route-max-message-bytes-invalid"></a>`websocket-route/max-message-bytes-invalid` | WebSocket maxMessageBytes is an integer within the allowed range. | Set maxMessageBytes to an integer within the range in the message. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1191
+ | <a id="websocket-route-path-prefix"></a>`websocket-route/path-prefix` | WebSocket route paths live under the WebSocket namespace prefix. | Start the path with the prefix named in the message. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1192
+ | <a id="websocket-route-path-wildcard"></a>`websocket-route/path-wildcard` | WebSocket route paths contain no wildcard. | Remove the * from the path. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1193
+
853
1194
  ## workspace
854
1195
 
855
1196
  | Rule | Summary | Fix | Source |
856
1197
  | --- | --- | --- | --- |
1198
+ | <a id="workspace-id-duplicate"></a>`workspace/id-duplicate` | Workspace ids are unique per feature. | Rename one of the workspaces. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
1199
+ | <a id="workspace-id-not-kebab"></a>`workspace/id-not-kebab` | Workspace ids are kebab-case. | Rename the workspace id to lowercase letters, digits and dashes. | `packages/framework/src/engine/boot-validator/definition-ui-extensions-rules.ts` |
857
1200
  | <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` |
858
1201
  | <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` |