@starci/eslint-canon-be 3.8.20 → 3.9.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 (164) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/package.json +1 -1
  3. package/runtime/bundle.json +192 -0
  4. package/runtime/engine/by-code-unit.mjs +6 -6
  5. package/runtime/engine/model-config.mjs +98 -76
  6. package/runtime/engine/orca-config.mjs +22 -17
  7. package/runtime/engine/release-config.mjs +22 -18
  8. package/runtime/engine/removed-vocabulary.mjs +21 -20
  9. package/runtime/engine/resources-config.mjs +42 -35
  10. package/runtime/engine/runtime-root.mjs +11 -13
  11. package/runtime/engine/secrets.mjs +170 -102
  12. package/runtime/engine/sonar-config.mjs +16 -13
  13. package/runtime/engine/temp-root.mjs +3 -9
  14. package/runtime/knowledge/hfs/canon-pins.yaml +10 -10
  15. package/runtime/knowledge/hfs/rules.yaml +6 -6
  16. package/runtime/knowledge/hfs/slots.yaml +2 -2
  17. package/runtime/knowledge/sonar-gate.yaml +1 -1
  18. package/runtime/packages/hfs/templates/app/package-scripts/package.json +1 -1
  19. package/runtime/scripts/api/git/cat-file.mjs +0 -1
  20. package/runtime/scripts/api/git/config-get.mjs +1 -2
  21. package/runtime/scripts/api/git/diff.mjs +0 -1
  22. package/runtime/scripts/api/git/lib.mjs +32 -32
  23. package/runtime/scripts/api/git/ls-files.mjs +0 -1
  24. package/runtime/scripts/api/git/ls-tree.mjs +0 -1
  25. package/runtime/scripts/api/git/merge-base.mjs +2 -3
  26. package/runtime/scripts/api/git/remote.mjs +0 -1
  27. package/runtime/scripts/api/git/rev-parse-query.mjs +0 -1
  28. package/runtime/scripts/api/git/show.mjs +0 -1
  29. package/runtime/scripts/hfs/allows.mjs +37 -38
  30. package/runtime/scripts/hfs/architecture/ast-walks.mjs +180 -163
  31. package/runtime/scripts/hfs/architecture/automatic-gates.mjs +80 -73
  32. package/runtime/scripts/hfs/architecture/backend-app-files.mjs +88 -77
  33. package/runtime/scripts/hfs/architecture/backend.mjs +378 -357
  34. package/runtime/scripts/hfs/architecture/background-unowned.mjs +201 -187
  35. package/runtime/scripts/hfs/architecture/canon-clones.mjs +260 -209
  36. package/runtime/scripts/hfs/architecture/canon-jsx-clones.mjs +149 -116
  37. package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +72 -68
  38. package/runtime/scripts/hfs/architecture/clones.mjs +212 -217
  39. package/runtime/scripts/hfs/architecture/config-unread.mjs +7 -9
  40. package/runtime/scripts/hfs/architecture/config.mjs +302 -268
  41. package/runtime/scripts/hfs/architecture/connection-map.mjs +258 -225
  42. package/runtime/scripts/hfs/architecture/constructor-deps.mjs +80 -71
  43. package/runtime/scripts/hfs/architecture/context-coupling.mjs +82 -77
  44. package/runtime/scripts/hfs/architecture/context-map.mjs +267 -234
  45. package/runtime/scripts/hfs/architecture/context-owner.mjs +73 -61
  46. package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +47 -43
  47. package/runtime/scripts/hfs/architecture/context-transaction.mjs +54 -52
  48. package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +113 -104
  49. package/runtime/scripts/hfs/architecture/contracts-readonly.mjs +288 -270
  50. package/runtime/scripts/hfs/architecture/contracts.mjs +408 -393
  51. package/runtime/scripts/hfs/architecture/cross-app-duplicate.mjs +50 -51
  52. package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +143 -119
  53. package/runtime/scripts/hfs/architecture/dead-exports.mjs +286 -228
  54. package/runtime/scripts/hfs/architecture/default-deny.mjs +129 -110
  55. package/runtime/scripts/hfs/architecture/doc-language.mjs +24 -19
  56. package/runtime/scripts/hfs/architecture/entity-registry.mjs +20 -22
  57. package/runtime/scripts/hfs/architecture/entrypoint.mjs +47 -45
  58. package/runtime/scripts/hfs/architecture/error-codes.mjs +37 -35
  59. package/runtime/scripts/hfs/architecture/error-masked.mjs +55 -59
  60. package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +24 -23
  61. package/runtime/scripts/hfs/architecture/feature-shape.mjs +40 -38
  62. package/runtime/scripts/hfs/architecture/framework-pinned.mjs +21 -21
  63. package/runtime/scripts/hfs/architecture/frontend-block-render.mjs +106 -98
  64. package/runtime/scripts/hfs/architecture/frontend-grammar.mjs +153 -150
  65. package/runtime/scripts/hfs/architecture/frontend-routing.mjs +161 -149
  66. package/runtime/scripts/hfs/architecture/frontend-world-render.mjs +343 -305
  67. package/runtime/scripts/hfs/architecture/frontend-world.mjs +340 -294
  68. package/runtime/scripts/hfs/architecture/frontend.mjs +174 -184
  69. package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +124 -106
  70. package/runtime/scripts/hfs/architecture/hfs-graph.mjs +52 -48
  71. package/runtime/scripts/hfs/architecture/hooks-are-hooks.mjs +81 -71
  72. package/runtime/scripts/hfs/architecture/i18n-keys.mjs +155 -141
  73. package/runtime/scripts/hfs/architecture/identity.mjs +141 -125
  74. package/runtime/scripts/hfs/architecture/index.mjs +272 -272
  75. package/runtime/scripts/hfs/architecture/injection-token-exported.mjs +45 -43
  76. package/runtime/scripts/hfs/architecture/jwt-ast.mjs +195 -176
  77. package/runtime/scripts/hfs/architecture/machine-ast.mjs +163 -155
  78. package/runtime/scripts/hfs/architecture/managed-scripts.mjs +19 -20
  79. package/runtime/scripts/hfs/architecture/module-per-transport.mjs +177 -172
  80. package/runtime/scripts/hfs/architecture/next-data-contract.mjs +100 -78
  81. package/runtime/scripts/hfs/architecture/next-data-inference.mjs +170 -154
  82. package/runtime/scripts/hfs/architecture/next-data-key.mjs +311 -275
  83. package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +17 -17
  84. package/runtime/scripts/hfs/architecture/next-data.mjs +351 -334
  85. package/runtime/scripts/hfs/architecture/operation-contract-roots.mjs +39 -37
  86. package/runtime/scripts/hfs/architecture/owners.mjs +97 -98
  87. package/runtime/scripts/hfs/architecture/package-shape.mjs +56 -55
  88. package/runtime/scripts/hfs/architecture/presentation.mjs +138 -130
  89. package/runtime/scripts/hfs/architecture/reachability.mjs +258 -241
  90. package/runtime/scripts/hfs/architecture/register-once.mjs +152 -139
  91. package/runtime/scripts/hfs/architecture/registration.mjs +301 -267
  92. package/runtime/scripts/hfs/architecture/required-files.mjs +172 -167
  93. package/runtime/scripts/hfs/architecture/route-files-thin.mjs +85 -77
  94. package/runtime/scripts/hfs/architecture/schema-owner.mjs +206 -181
  95. package/runtime/scripts/hfs/architecture/server-action.mjs +48 -48
  96. package/runtime/scripts/hfs/architecture/side-boundary.mjs +2 -5
  97. package/runtime/scripts/hfs/architecture/source-names-shape.mjs +261 -259
  98. package/runtime/scripts/hfs/architecture/source-names.mjs +304 -278
  99. package/runtime/scripts/hfs/architecture/sql-keys.mjs +277 -194
  100. package/runtime/scripts/hfs/architecture/sql-owner.mjs +236 -194
  101. package/runtime/scripts/hfs/architecture/sql-returning.mjs +46 -45
  102. package/runtime/scripts/hfs/architecture/sql-token-forms.mjs +86 -74
  103. package/runtime/scripts/hfs/architecture/sql-tokens.mjs +456 -341
  104. package/runtime/scripts/hfs/architecture/staged-consumers.mjs +35 -30
  105. package/runtime/scripts/hfs/architecture/surface.mjs +64 -74
  106. package/runtime/scripts/hfs/architecture/symbols.mjs +209 -216
  107. package/runtime/scripts/hfs/architecture/test-world-files.mjs +165 -155
  108. package/runtime/scripts/hfs/architecture/tiers.mjs +161 -154
  109. package/runtime/scripts/hfs/architecture/transport-owner.mjs +155 -149
  110. package/runtime/scripts/hfs/architecture/type-context.mjs +255 -250
  111. package/runtime/scripts/hfs/architecture/typescript.mjs +358 -318
  112. package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +110 -92
  113. package/runtime/scripts/hfs/declaration-shape.mjs +140 -103
  114. package/runtime/scripts/hfs/declaration-slots.mjs +64 -61
  115. package/runtime/scripts/hfs/edition-slots.mjs +43 -40
  116. package/runtime/scripts/hfs/linear-text.mjs +20 -20
  117. package/runtime/scripts/hfs/param-names.mjs +6 -11
  118. package/runtime/scripts/hfs/path-findings.mjs +120 -100
  119. package/runtime/scripts/hfs/repo-identity.mjs +55 -42
  120. package/runtime/scripts/hfs/rule-catalog.mjs +353 -257
  121. package/runtime/scripts/hfs/rule-params-shape.mjs +60 -47
  122. package/runtime/scripts/hfs/rules/database-migrations.mjs +428 -388
  123. package/runtime/scripts/hfs/rules/fe-no-tests.mjs +37 -36
  124. package/runtime/scripts/hfs/rules/read.mjs +19 -15
  125. package/runtime/scripts/hfs/rules/secrets.mjs +1 -1
  126. package/runtime/scripts/hfs/rules/spec-placement.mjs +12 -13
  127. package/runtime/scripts/hfs/slot-app-view.mjs +69 -74
  128. package/runtime/scripts/hfs/slot-classify.mjs +42 -38
  129. package/runtime/scripts/hfs/slot-errors.mjs +8 -7
  130. package/runtime/scripts/hfs/slot-imports.mjs +70 -63
  131. package/runtime/scripts/hfs/slot-manifest-shape.mjs +74 -52
  132. package/runtime/scripts/hfs/slot-match.mjs +122 -111
  133. package/runtime/scripts/hfs/slot-path.mjs +0 -2
  134. package/runtime/scripts/hfs/slot-required.mjs +65 -59
  135. package/runtime/scripts/hfs/slot-semantic-problems.mjs +138 -112
  136. package/runtime/scripts/hfs/slot-side-problems.mjs +23 -19
  137. package/runtime/scripts/hfs/slots.mjs +175 -152
  138. package/runtime/scripts/hfs/test-world-slot.mjs +0 -1
  139. package/runtime/scripts/hfs/trailing-slashes.mjs +4 -4
  140. package/runtime/scripts/hfs/typescript-programs.mjs +66 -69
  141. package/runtime/scripts/hfs/view.mjs +38 -40
  142. package/runtime/scripts/lib/dockerfile.mjs +131 -114
  143. package/runtime/scripts/lib/env.mjs +3 -6
  144. package/runtime/scripts/lib/event-contract.mjs +73 -78
  145. package/runtime/scripts/lib/git.mjs +15 -16
  146. package/runtime/scripts/lib/glob.mjs +23 -14
  147. package/runtime/scripts/lib/grammar-lint.mjs +33 -37
  148. package/runtime/scripts/lib/i18n.mjs +32 -35
  149. package/runtime/scripts/lib/in-order.mjs +57 -38
  150. package/runtime/scripts/lib/json-clone.mjs +45 -36
  151. package/runtime/scripts/lib/json.mjs +26 -14
  152. package/runtime/scripts/lib/language.mjs +133 -129
  153. package/runtime/scripts/lib/list.mjs +9 -14
  154. package/runtime/scripts/lib/mutation-fence.mjs +10 -5
  155. package/runtime/scripts/lib/path-key.mjs +53 -38
  156. package/runtime/scripts/lib/read-text.mjs +30 -17
  157. package/runtime/scripts/lib/regex.mjs +1 -2
  158. package/runtime/scripts/lib/same-text.mjs +0 -1
  159. package/runtime/scripts/lib/sops-envelope.mjs +148 -120
  160. package/runtime/scripts/lib/stack-services.mjs +128 -129
  161. package/runtime/scripts/lib/ts-analysis.mjs +28 -26
  162. package/runtime/scripts/lib/ts-ast.mjs +36 -42
  163. package/runtime/scripts/lib/walk.mjs +33 -27
  164. package/runtime/scripts/lib/yaml-cached.mjs +4 -4
@@ -52,345 +52,345 @@ import { checkBackendIdentity, IDENTITY_RULE_IDS } from './identity.mjs';
52
52
  import { checkServerActions, SERVER_ACTION_RULE_IDS } from './server-action.mjs';
53
53
  import { LINT_CODES, onLintSurface } from './surface.mjs';
54
54
  import { byCodeUnit } from '../../lib/list.mjs';
55
-
56
55
  export { REGISTRATION_RULE_IDS, SWR_DATA_RULE_IDS };
57
-
58
56
  const LIMITATIONS = [
59
- 'This is a static TypeScript dependency and source-shape check; it does not prove runtime dependency-injection bindings, global/provider scope, state lifetime, server/client behavior, feature-versus-capability ownership, route behavior, or business correctness.',
60
- 'Dependencies hidden behind constructed aliases, reflection, or calls other than direct import()/require() syntax require separate review.',
61
- 'Protocol surfaces selected through reflection, nonliteral computed properties, or aliases constructed beyond static import/re-export bindings require separate review.',
62
- 'Backend source-shape rules classify only resolved roots, declarations, framework symbols, and static decorator arguments; cohesive capability, error, persistence, and migration ownership still require design and runtime evidence.',
63
- 'Backend contract rules prove selected declaration and readonly field forms only; they do not prove runtime validation, serialization compatibility, provider scope, token identity, or dependency behavior.',
64
- 'Frontend SWR lifecycle rules prove declared key bindings and installed SWR identity only; domain identity completeness, stale-result behavior and mutation effects require target behavior evidence.',
57
+ 'This is a static TypeScript dependency and source-shape check; it does not prove runtime dependency-injection bindings, global/provider scope, state lifetime, server/client behavior, feature-versus-capability ownership, route behavior, or business correctness.',
58
+ 'Dependencies hidden behind constructed aliases, reflection, or calls other than direct import()/require() syntax require separate review.',
59
+ 'Protocol surfaces selected through reflection, nonliteral computed properties, or aliases constructed beyond static import/re-export bindings require separate review.',
60
+ 'Backend source-shape rules classify only resolved roots, declarations, framework symbols, and static decorator arguments; cohesive capability, error, persistence, and migration ownership still require design and runtime evidence.',
61
+ 'Backend contract rules prove selected declaration and readonly field forms only; they do not prove runtime validation, serialization compatibility, provider scope, token identity, or dependency behavior.',
62
+ 'Frontend SWR lifecycle rules prove declared key bindings and installed SWR identity only; domain identity completeness, stale-result behavior and mutation effects require target behavior evidence.',
65
63
  ];
66
-
67
64
  // The backend composition and data machine (R29, R32, R33, R35, R38, R39, R41, R45, R46, R47, R48, R84, R85, R86): name -> [check, the rule ids it makes truthful].
68
65
  const BACKEND_MACHINE = {
69
- connectionMap: [checkConnectionMap, CONNECTION_RULE_IDS],
70
- sqlOwner: [checkSqlOwner, SQL_OWNER_RULE_IDS],
71
- registerOnce: [checkRegisterOnce, REGISTER_ONCE_RULE_IDS],
72
- errorMasked: [checkErrorMasked, ERROR_MASKED_RULE_IDS],
73
- defaultDeny: [checkDefaultDeny, DEFAULT_DENY_RULE_IDS],
74
- entrypoints: [checkEntrypoints, ENTRYPOINT_RULE_IDS],
75
- errorCodes: [checkErrorCodes, ERROR_CODE_RULE_IDS],
76
- featureShape: [checkFeatureShape, FEATURE_SHAPE_RULE_IDS],
77
- unitSpecProviders: [checkUnitSpecProviders, UNIT_SPEC_PROVIDERS_RULE_IDS],
78
- injectionTokenExported: [checkInjectionTokenExported, INJECTION_TOKEN_EXPORTED_RULE_IDS],
79
- schemaOwner: [checkSchemaOwner, SCHEMA_OWNER_RULE_IDS],
80
- sqlReturning: [checkSqlReturning, SQL_RETURNING_RULE_IDS],
81
- contextOwner: [checkContextOwner, CONTEXT_OWNER_RULE_IDS],
82
- contextCoupling: [checkContextCoupling, CONTEXT_COUPLING_RULE_IDS],
83
- contextTransaction: [checkContextTransaction, CONTEXT_TRANSACTION_RULE_IDS],
84
- contextPlatformTables: [checkContextPlatformTables, CONTEXT_PLATFORM_TABLES_RULE_IDS],
85
- modulePerTransport: [checkModulePerTransport, MODULE_PER_TRANSPORT_RULE_IDS],
86
- backgroundUnowned: [checkBackgroundUnowned, BACKGROUND_UNOWNED_RULE_IDS],
87
- testWorldFiles: [checkTestWorldFiles, TEST_WORLD_FILES_RULE_IDS],
88
- contractFixtureGuard: [checkContractFixtureGuard, CONTRACT_FIXTURE_GUARD_RULE_IDS],
89
- identity: [checkBackendIdentity, IDENTITY_RULE_IDS],
66
+ connectionMap: [checkConnectionMap, CONNECTION_RULE_IDS],
67
+ sqlOwner: [checkSqlOwner, SQL_OWNER_RULE_IDS],
68
+ registerOnce: [checkRegisterOnce, REGISTER_ONCE_RULE_IDS],
69
+ errorMasked: [checkErrorMasked, ERROR_MASKED_RULE_IDS],
70
+ defaultDeny: [checkDefaultDeny, DEFAULT_DENY_RULE_IDS],
71
+ entrypoints: [checkEntrypoints, ENTRYPOINT_RULE_IDS],
72
+ errorCodes: [checkErrorCodes, ERROR_CODE_RULE_IDS],
73
+ featureShape: [checkFeatureShape, FEATURE_SHAPE_RULE_IDS],
74
+ unitSpecProviders: [checkUnitSpecProviders, UNIT_SPEC_PROVIDERS_RULE_IDS],
75
+ injectionTokenExported: [checkInjectionTokenExported, INJECTION_TOKEN_EXPORTED_RULE_IDS],
76
+ schemaOwner: [checkSchemaOwner, SCHEMA_OWNER_RULE_IDS],
77
+ sqlReturning: [checkSqlReturning, SQL_RETURNING_RULE_IDS],
78
+ contextOwner: [checkContextOwner, CONTEXT_OWNER_RULE_IDS],
79
+ contextCoupling: [checkContextCoupling, CONTEXT_COUPLING_RULE_IDS],
80
+ contextTransaction: [checkContextTransaction, CONTEXT_TRANSACTION_RULE_IDS],
81
+ contextPlatformTables: [checkContextPlatformTables, CONTEXT_PLATFORM_TABLES_RULE_IDS],
82
+ modulePerTransport: [checkModulePerTransport, MODULE_PER_TRANSPORT_RULE_IDS],
83
+ backgroundUnowned: [checkBackgroundUnowned, BACKGROUND_UNOWNED_RULE_IDS],
84
+ testWorldFiles: [checkTestWorldFiles, TEST_WORLD_FILES_RULE_IDS],
85
+ contractFixtureGuard: [checkContractFixtureGuard, CONTRACT_FIXTURE_GUARD_RULE_IDS],
86
+ identity: [checkBackendIdentity, IDENTITY_RULE_IDS],
90
87
  };
91
-
92
88
  // The frontend repository machine (R21, R50, R54, R55, R56, R63, R94, R106): same shape, run for a front-end repository only.
93
89
  const FRONTEND_MACHINE = {
94
- transportOwner: [checkTransportOwner, TRANSPORT_OWNER_RULE_IDS],
95
- routeFilesThin: [checkRouteFilesThin, ROUTE_FILES_THIN_RULE_IDS],
96
- hooksAreHooks: [checkHooksAreHooks, HOOKS_ARE_HOOKS_RULE_IDS],
97
- packageShape: [checkPackageShape, PACKAGE_SHAPE_RULE_IDS],
98
- clientReachesServer: [checkClientReachesServer, CLIENT_REACHES_SERVER_RULE_IDS],
99
- crossAppDuplicate: [checkCrossAppDuplicate, CROSS_APP_DUPLICATE_RULE_IDS],
100
- feSlotAllows: [checkFeSlotAllows, FE_SLOT_ALLOWS_RULE_IDS],
101
- i18nKeys: [checkI18nKeys, I18N_KEYS_RULE_IDS],
102
- serverActions: [checkServerActions, SERVER_ACTION_RULE_IDS],
90
+ transportOwner: [checkTransportOwner, TRANSPORT_OWNER_RULE_IDS],
91
+ routeFilesThin: [checkRouteFilesThin, ROUTE_FILES_THIN_RULE_IDS],
92
+ hooksAreHooks: [checkHooksAreHooks, HOOKS_ARE_HOOKS_RULE_IDS],
93
+ packageShape: [checkPackageShape, PACKAGE_SHAPE_RULE_IDS],
94
+ clientReachesServer: [checkClientReachesServer, CLIENT_REACHES_SERVER_RULE_IDS],
95
+ crossAppDuplicate: [checkCrossAppDuplicate, CROSS_APP_DUPLICATE_RULE_IDS],
96
+ feSlotAllows: [checkFeSlotAllows, FE_SLOT_ALLOWS_RULE_IDS],
97
+ i18nKeys: [checkI18nKeys, I18N_KEYS_RULE_IDS],
98
+ serverActions: [checkServerActions, SERVER_ACTION_RULE_IDS],
103
99
  };
104
-
105
100
  /** Errors the machine reports when a program cannot be built or an edge cannot be proven: it cannot judge, so it refuses. */
106
101
  const COMMON_REFUSAL_RULE_IDS = [
107
- 'ARCH_DYNAMIC_DEPENDENCY_UNPROVEN',
108
- 'ARCH_INTERNAL_IMPORT_OUTSIDE',
109
- 'ARCH_INTERNAL_IMPORT_UNRESOLVED',
110
- 'ARCH_NO_SOURCE',
111
- 'ARCH_SYNTAX_INVALID',
112
- 'ARCH_TSCONFIG_INVALID',
113
- 'ARCH_TSCONFIG_MISSING',
114
- 'ARCH_TSCONFIG_REFERENCE_OUTSIDE',
102
+ 'ARCH_DYNAMIC_DEPENDENCY_UNPROVEN',
103
+ 'ARCH_INTERNAL_IMPORT_OUTSIDE',
104
+ 'ARCH_INTERNAL_IMPORT_UNRESOLVED',
105
+ 'ARCH_NO_SOURCE',
106
+ 'ARCH_SYNTAX_INVALID',
107
+ 'ARCH_TSCONFIG_INVALID',
108
+ 'ARCH_TSCONFIG_MISSING',
109
+ 'ARCH_TSCONFIG_REFERENCE_OUTSIDE',
115
110
  ];
116
111
  const COMMON_RULE_IDS = [
117
- ...COMMON_REFUSAL_RULE_IDS,
118
- 'ARCH_PACKAGE_EXPORT_BYPASS',
119
- 'ARCH_PACKAGE_IMPORTS_APP',
112
+ ...COMMON_REFUSAL_RULE_IDS,
113
+ 'ARCH_PACKAGE_EXPORT_BYPASS',
114
+ 'ARCH_PACKAGE_IMPORTS_APP',
120
115
  ];
121
116
  const BACKEND_RULE_IDS = [
122
- 'BE_APP_BUSINESS_ROLE',
123
- 'BE_APP_COMPOSITION_ONLY',
124
- 'BE_APPLICATION_IMPORTS_TRANSPORT',
125
- 'BE_APPLICATION_TRANSPORT_FRAMEWORK',
117
+ 'BE_APP_BUSINESS_ROLE',
118
+ 'BE_APP_COMPOSITION_ONLY',
119
+ 'BE_APPLICATION_IMPORTS_TRANSPORT',
120
+ 'BE_APPLICATION_TRANSPORT_FRAMEWORK',
126
121
  ];
127
122
  const FRONTEND_RULE_IDS = [
128
- 'FE_BLOCK_PRODUCT_HOOK_DEFINITION',
129
- 'FE_COMPONENT_WORLD_OWNERSHIP',
130
- 'FE_COMPONENT_DEEP_HOOK_IMPORT',
131
- 'FE_CONNECTED_BLOCK_RENDER_PAIR',
132
- 'FE_CUSTOM_HOOK_LOCATION',
133
- 'FE_PURE_REACHES_DATA',
134
- 'FE_PURE_WORLD_HOOK',
135
- 'FE_PURE_WORLD_IMPORT',
136
- 'FE_ROUTE_CLIENT_BOUNDARY',
137
- 'FE_ROUTE_CLIENT_HOOK',
138
- 'FE_ROUTE_DEFAULT_EXPORT',
139
- 'FE_ROUTE_DRAWING_DECISION',
140
- 'FE_ROUTE_ONE_PAGE',
141
- 'FE_SOURCE_LAYOUT_INVALID',
142
- 'FE_WORLD_OWNER_RENDER_BOUNDARY',
123
+ 'FE_BLOCK_PRODUCT_HOOK_DEFINITION',
124
+ 'FE_COMPONENT_WORLD_OWNERSHIP',
125
+ 'FE_COMPONENT_DEEP_HOOK_IMPORT',
126
+ 'FE_CONNECTED_BLOCK_RENDER_PAIR',
127
+ 'FE_CUSTOM_HOOK_LOCATION',
128
+ 'FE_PURE_REACHES_DATA',
129
+ 'FE_PURE_WORLD_HOOK',
130
+ 'FE_PURE_WORLD_IMPORT',
131
+ 'FE_ROUTE_CLIENT_BOUNDARY',
132
+ 'FE_ROUTE_CLIENT_HOOK',
133
+ 'FE_ROUTE_DEFAULT_EXPORT',
134
+ 'FE_ROUTE_DRAWING_DECISION',
135
+ 'FE_ROUTE_ONE_PAGE',
136
+ 'FE_SOURCE_LAYOUT_INVALID',
137
+ 'FE_WORLD_OWNER_RENDER_BOUNDARY',
143
138
  ];
144
139
  const OWNER_RULE_IDS = ['ARCH_OWNER_EXPORT_BYPASS', 'ARCH_OWNER_EXPORT_STAR'];
145
140
  const GRAMMAR_RULE_IDS = ['ARCH_GRAMMAR_CONTRACT_INVALID', 'ARCH_GRAMMAR_EXPORT_BYPASS'];
146
-
147
141
  /**
148
142
  * Every code the machine reports as an error because it cannot judge (a check that cannot run is an error, never a pass).
149
143
  * These are infrastructure refusals, not obligations, so no rule of knowledge/hfs/rules.yaml owns them.
150
144
  */
151
145
  export const ERROR_RULE_IDS = Object.freeze([
152
- 'ARCH_COMPILER_FAILURE', 'ARCH_CONFIG_INVALID', 'ARCH_EXECUTION_UNAVAILABLE', 'ARCH_KNOWLEDGE_UNAVAILABLE', 'ARCH_TYPESCRIPT_INVALID', 'ARCH_TYPESCRIPT_MISSING',
153
- ...COMMON_REFUSAL_RULE_IDS,
146
+ 'ARCH_COMPILER_FAILURE', 'ARCH_CONFIG_INVALID', 'ARCH_EXECUTION_UNAVAILABLE', 'ARCH_KNOWLEDGE_UNAVAILABLE', 'ARCH_TYPESCRIPT_INVALID', 'ARCH_TYPESCRIPT_MISSING',
147
+ ...COMMON_REFUSAL_RULE_IDS,
154
148
  ]);
155
-
156
149
  const machineIds = () => [
157
- ...TIER_RULE_IDS, ...REACHABILITY_RULE_IDS, ...DEAD_EXPORT_RULE_IDS, ...REQUIRED_FILE_RULE_IDS, ...CLONE_RULE_IDS, ...SYMBOL_RULE_IDS,
158
- ...Object.values(BACKEND_MACHINE).flatMap(([, ids]) => ids), ...Object.values(FRONTEND_MACHINE).flatMap(([, ids]) => ids),
150
+ ...TIER_RULE_IDS, ...REACHABILITY_RULE_IDS, ...DEAD_EXPORT_RULE_IDS, ...REQUIRED_FILE_RULE_IDS, ...CLONE_RULE_IDS, ...SYMBOL_RULE_IDS,
151
+ ...Object.values(BACKEND_MACHINE).flatMap(([, ids]) => ids), ...Object.values(FRONTEND_MACHINE).flatMap(([, ids]) => ids),
159
152
  ];
160
153
  /**
161
154
  * The rules only the HFS machine emits: the tier, reachability, dead-export, required-file, clone and symbol checks and the
162
155
  * backend composition and data machine and frontend repository machine. A spec about another rule judges its own
163
156
  * report without these (they have their own specs); every one of them is in ARCHITECTURE_RULE_IDS.
164
157
  */
165
- const HFS_MACHINE_RULE_IDS = Object.freeze((() => {
166
- const ordinary = new Set([...COMMON_RULE_IDS, ...BACKEND_RULE_IDS, ...FRONTEND_RULE_IDS, ...OWNER_RULE_IDS, ...GRAMMAR_RULE_IDS, ...REGISTRATION_RULE_IDS,
167
- ...SWR_DATA_RULE_IDS, SOURCE_LAYOUT_RULE_ID, SOURCE_NAME_RULE_ID, PUBLIC_CONTRACT_RULE_ID, READONLY_BOUNDARY_RULE_ID]);
168
- return [...new Set(machineIds().filter((id) => !ordinary.has(id)))].sort(byCodeUnit);
158
+ export const HFS_MACHINE_RULE_IDS = Object.freeze((() => {
159
+ const ordinary = new Set([...COMMON_RULE_IDS, ...BACKEND_RULE_IDS, ...FRONTEND_RULE_IDS, ...OWNER_RULE_IDS, ...GRAMMAR_RULE_IDS, ...REGISTRATION_RULE_IDS,
160
+ ...SWR_DATA_RULE_IDS, SOURCE_LAYOUT_RULE_ID, SOURCE_NAME_RULE_ID, PUBLIC_CONTRACT_RULE_ID, READONLY_BOUNDARY_RULE_ID]);
161
+ return [...new Set(machineIds().filter((id) => !ordinary.has(id)))].sort(byCodeUnit);
169
162
  })());
170
-
171
163
  /** Every code the machine can emit, derived from the rule id lists of its checks (`starci app check` ships exactly these why entries). */
172
164
  export const ARCHITECTURE_RULE_IDS = Object.freeze([...new Set([
173
- ...COMMON_RULE_IDS, ...BACKEND_RULE_IDS, ...FRONTEND_RULE_IDS, ...HFS_RULE_IDS, ...TIER_RULE_IDS, ...REACHABILITY_RULE_IDS,
174
- ...DEAD_EXPORT_RULE_IDS, ...DOC_LANGUAGE_RULE_IDS, ...REQUIRED_FILE_RULE_IDS, ...CLONE_RULE_IDS, ...OWNER_RULE_IDS, ...GRAMMAR_RULE_IDS,
175
- ...REGISTRATION_RULE_IDS, ...SWR_DATA_RULE_IDS, ...SYMBOL_RULE_IDS, SOURCE_LAYOUT_RULE_ID, SOURCE_NAME_RULE_ID, PUBLIC_CONTRACT_RULE_ID,
176
- READONLY_BOUNDARY_RULE_ID, ...ERROR_RULE_IDS, ...CONFIG_UNREAD_RULE_IDS, ...Object.values(BACKEND_MACHINE).flatMap(([, ids]) => ids), ...Object.values(FRONTEND_MACHINE).flatMap(([, ids]) => ids),
177
- ])].sort(byCodeUnit));
178
-
165
+ ...COMMON_RULE_IDS, ...BACKEND_RULE_IDS, ...FRONTEND_RULE_IDS, ...HFS_RULE_IDS, ...TIER_RULE_IDS, ...REACHABILITY_RULE_IDS,
166
+ ...DEAD_EXPORT_RULE_IDS, ...DOC_LANGUAGE_RULE_IDS, ...REQUIRED_FILE_RULE_IDS, ...CLONE_RULE_IDS, ...OWNER_RULE_IDS, ...GRAMMAR_RULE_IDS,
167
+ ...REGISTRATION_RULE_IDS, ...SWR_DATA_RULE_IDS, ...SYMBOL_RULE_IDS, SOURCE_LAYOUT_RULE_ID, SOURCE_NAME_RULE_ID, PUBLIC_CONTRACT_RULE_ID,
168
+ READONLY_BOUNDARY_RULE_ID, ...ERROR_RULE_IDS, ...CONFIG_UNREAD_RULE_IDS, ...Object.values(BACKEND_MACHINE).flatMap(([, ids]) => ids), ...Object.values(FRONTEND_MACHINE).flatMap(([, ids]) => ids),
169
+ ])].sort(byCodeUnit));
179
170
  function stable(items) {
180
- return items.sort((a, b) => `${a.path ?? ''}:${a.line ?? 0}:${a.column ?? 0}:${a.ruleId}`.localeCompare(`${b.path ?? ''}:${b.line ?? 0}:${b.column ?? 0}:${b.ruleId}`));
171
+ return items.sort((a, b) => `${a.path ?? ''}:${a.line ?? 0}:${a.column ?? 0}:${a.ruleId}`.localeCompare(`${b.path ?? ''}:${b.line ?? 0}:${b.column ?? 0}:${b.ruleId}`));
181
172
  }
182
-
183
173
  const ownerPublicApiOf = (owners, missingEntries) => {
184
- if (!owners.length) return { status: 'unavailable', reason: 'no slot owner instance with an entry file exists in the repository' };
185
- if (missingEntries.length) return { status: 'unavailable', reason: 'one or more declared owner entries are outside the checked production TypeScript or JavaScript program',
186
- missingEntries: missingEntries.map(owner => owner.entry).sort(byCodeUnit) };
187
- return { status: 'checked', declarations: owners.length };
174
+ if (!owners.length)
175
+ return { status: 'unavailable', reason: 'no slot owner instance with an entry file exists in the repository' };
176
+ if (missingEntries.length)
177
+ return { status: 'unavailable', reason: 'one or more declared owner entries are outside the checked production TypeScript or JavaScript program',
178
+ missingEntries: missingEntries.map(owner => owner.entry).sort(byCodeUnit) };
179
+ return { status: 'checked', declarations: owners.length };
188
180
  };
189
-
190
- const grammarContractOf = config => {
191
- if (!config.kinds.includes('frontend')) return { status: 'not-applicable' };
192
- if (config.frontend.grammar) return { status: 'checked', package: config.frontend.grammar.package };
193
- return { status: 'unavailable', reason: 'no app has a src/app/globals.css to judge against the Grammar style entry' };
181
+ const grammarContractOf = (config) => {
182
+ if (!config.kinds.includes('frontend'))
183
+ return { status: 'not-applicable' };
184
+ if (config.frontend.grammar)
185
+ return { status: 'checked', package: config.frontend.grammar.package };
186
+ return { status: 'unavailable', reason: 'no app has a src/app/globals.css to judge against the Grammar style entry' };
194
187
  };
195
-
196
188
  function invalidConfigurationResult(repositoryRoot, error) {
197
- const hfs = checkHfsWithoutConfig(repositoryRoot);
198
- return { schema: 'starci/architecture-check@1', ok: false, repository: String(repositoryRoot ?? ''), kinds: [], files: 0,
199
- compiler: null, violations: stable(hfs.violations), coverage: { hfs: hfs.coverage },
200
- errors: [{ ruleId: /^(HFS_[A-Z_]+):/.exec(String(error.message))?.[1] ?? 'ARCH_CONFIG_INVALID', message: String(error.message ?? error).replace(/^HFS_[A-Z_]+:\s*/, '') }], limitations: LIMITATIONS };
189
+ const hfs = repositoryRoot === undefined ? { violations: [], coverage: { status: 'unavailable', reason: 'repository root is unavailable' } } : checkHfsWithoutConfig(repositoryRoot);
190
+ return { schema: 'starci/architecture-check@1', ok: false, repository: String(repositoryRoot ?? ''), kinds: [], files: 0,
191
+ compiler: null, violations: stable(hfs.violations), coverage: { hfs: hfs.coverage },
192
+ errors: [{ ruleId: /^(HFS_[A-Z_]+):/.exec(String(error.message))?.[1] ?? 'ARCH_CONFIG_INVALID', message: String(error.message ?? error).replace(/^HFS_[A-Z_]+:\s*/, '') }], limitations: LIMITATIONS };
201
193
  }
202
-
203
194
  function compilerFailureResult(config, hfs, error) {
204
- const message = String(error.message ?? error);
205
- const match = /^(ARCH_[A-Z_]+):\s*/.exec(message);
206
- return { schema: 'starci/architecture-check@1', ok: false, repository: config.root, kinds: config.kinds, files: 0,
207
- compiler: null, violations: hfs.violations, coverage: { hfs: hfs.coverage },
208
- errors: [{ ruleId: match?.[1] ?? 'ARCH_COMPILER_FAILURE', message: message.replace(/^(ARCH_[A-Z_]+):\s*/, '') }], limitations: LIMITATIONS };
195
+ const message = String(error.message ?? error);
196
+ const match = /^(ARCH_[A-Z_]+):\s*/.exec(message);
197
+ return { schema: 'starci/architecture-check@1', ok: false, repository: config.root, kinds: config.kinds, files: 0,
198
+ compiler: null, violations: hfs.violations, coverage: { hfs: hfs.coverage },
199
+ errors: [{ ruleId: match?.[1] ?? 'ARCH_COMPILER_FAILURE', message: message.replace(/^(ARCH_[A-Z_]+):\s*/, '') }], limitations: LIMITATIONS };
209
200
  }
210
-
211
201
  function runBackendChecks(config, context, paths, injectedTypeScript, violations) {
212
- violations.push(...checkBackend(config, context));
213
- // A slice may omit every app root. Registration ownership needs the complete
214
- // composition graph even when the caller asks for findings in only one path.
215
- const registrationContext = paths.length && config.backend.moduleRegistration
216
- ? buildTypeScriptContext(config, injectedTypeScript) : context;
217
- const registration = checkModuleRegistration(config, registrationContext);
218
- violations.push(...registration.violations);
219
- const sourceShape = checkBackendSourceShape(config, context);
220
- violations.push(...sourceShape.violations);
221
- const contracts = checkBackendContracts(config, context);
222
- violations.push(...contracts.violations);
223
- return { moduleRegistration: registration.coverage, backendSourceShape: sourceShape.coverage, backendContractTypeForm: contracts.coverage };
202
+ violations.push(...checkBackend(config, context));
203
+ // A slice may omit every app root. Registration ownership needs the complete
204
+ // composition graph even when the caller asks for findings in only one path.
205
+ const registrationContext = paths.length && config.backend.moduleRegistration
206
+ ? buildTypeScriptContext(config, injectedTypeScript) : context;
207
+ const registration = checkModuleRegistration(config, registrationContext);
208
+ violations.push(...registration.violations);
209
+ const sourceShape = checkBackendSourceShape(config, context);
210
+ violations.push(...sourceShape.violations);
211
+ const contracts = checkBackendContracts(config, context);
212
+ violations.push(...contracts.violations);
213
+ return { moduleRegistration: registration.coverage, backendSourceShape: sourceShape.coverage, backendContractTypeForm: contracts.coverage };
224
214
  }
225
-
226
215
  function runFrontendChecks(config, context, violations) {
227
- let frontendChecked = true;
228
- try {
229
- violations.push(...checkFrontend(config, context));
230
- } catch (error) {
231
- const message = String(error.message ?? error);
232
- const match = /^(ARCH_[A-Z_]+):\s*/.exec(message);
233
- if (!match) throw error;
234
- context.errors.push({ ruleId: match[1], message: message.slice(match[0].length) });
235
- frontendChecked = false;
236
- }
237
- const dataLifecycle = checkFrontendDataLifecycle(config, context);
238
- violations.push(...dataLifecycle.violations);
239
- return { frontendChecked, frontendDataLifecycle: dataLifecycle.coverage };
216
+ let frontendChecked = true;
217
+ try {
218
+ violations.push(...checkFrontend(config, context));
219
+ }
220
+ catch (error) {
221
+ const message = String(error.message ?? error);
222
+ const match = /^(ARCH_[A-Z_]+):\s*/.exec(message);
223
+ if (!match)
224
+ throw error;
225
+ context.errors.push({ ruleId: match[1] ?? '', message: message.slice(match[0].length) });
226
+ frontendChecked = false;
227
+ }
228
+ const dataLifecycle = checkFrontendDataLifecycle(config, context);
229
+ violations.push(...dataLifecycle.violations);
230
+ return { frontendChecked, frontendDataLifecycle: dataLifecycle.coverage };
240
231
  }
241
-
242
232
  function runHfsMachine(config, context, paths, injectedTypeScript, base, fast, violations) {
243
- // HFS machine: the slot-driven graph checks read the whole program, also when the caller asked for one path.
244
- const hfsContext = paths.length ? buildTypeScriptContext(config, injectedTypeScript) : context;
245
- const hfsChecks = { tiers: null, reachability: null, deadExports: null, requiredFiles: null, clones: null, symbols: null, docLanguage: null };
246
- if (!hfsContext.program) return hfsChecks;
247
- const graph = buildHfsGraph(config, hfsContext);
248
- const input = { config, context: hfsContext, graph, base };
249
- const runs = { tiers: () => checkTiers(graph), reachability: () => checkReachability(input), deadExports: () => checkDeadExports(input),
250
- requiredFiles: () => checkRequiredFiles(input), clones: () => checkClones(input), symbols: () => checkSymbols(input), docLanguage: () => checkDocLanguage(input) };
251
- if (graph.profile === 'be') for (const [name, [check]] of Object.entries(BACKEND_MACHINE)) runs[name] = () => check(input);
252
- if (graph.profile === 'fe') for (const [name, [check]] of Object.entries(FRONTEND_MACHINE)) runs[name] = () => check(input);
253
- if (fast) { delete runs.deadExports; delete runs.clones; delete runs.symbols; }
254
- for (const [name, run] of Object.entries(runs)) {
255
- const result = run();
256
- violations.push(...result.violations.map(violation => ({ ...violation, check: name })));
257
- hfsChecks[name] = result.coverage;
258
- }
259
- return hfsChecks;
233
+ // HFS machine: the slot-driven graph checks read the whole program, also when the caller asked for one path.
234
+ const hfsContext = paths.length ? buildTypeScriptContext(config, injectedTypeScript) : context;
235
+ const hfsChecks = { tiers: null, reachability: null, deadExports: null, requiredFiles: null, clones: null, symbols: null, docLanguage: null };
236
+ if (!hfsContext.program)
237
+ return hfsChecks;
238
+ const graph = buildHfsGraph(config, hfsContext);
239
+ const input = { config, context: hfsContext, graph, base };
240
+ const runs = { tiers: () => checkTiers(graph), reachability: () => checkReachability(input), deadExports: () => checkDeadExports(input),
241
+ requiredFiles: () => checkRequiredFiles(input), clones: () => checkClones(input), symbols: () => checkSymbols(input), docLanguage: () => checkDocLanguage(input) };
242
+ if (graph.profile === 'be')
243
+ for (const [name, [check]] of Object.entries(BACKEND_MACHINE))
244
+ runs[name] = () => check(input);
245
+ if (graph.profile === 'fe')
246
+ for (const [name, [check]] of Object.entries(FRONTEND_MACHINE))
247
+ runs[name] = () => check(input);
248
+ if (fast) {
249
+ delete runs.deadExports;
250
+ delete runs.clones;
251
+ delete runs.symbols;
252
+ }
253
+ for (const [name, run] of Object.entries(runs)) {
254
+ const result = run();
255
+ violations.push(...result.violations.map(violation => ({ ...violation, check: name })));
256
+ hfsChecks[name] = result.coverage;
257
+ }
258
+ return hfsChecks;
260
259
  }
261
-
262
260
  function hfsRuleIds(hfs) {
263
- return hfs.coverage.status === 'checked' ? HFS_RULE_IDS : [];
261
+ return hfs.coverage.status === 'checked' ? HFS_RULE_IDS : [];
264
262
  }
265
-
266
263
  function hfsCheckRuleIds(hfsChecks) {
267
- return [
268
- ...(hfsChecks.tiers ? TIER_RULE_IDS : []),
269
- ...(hfsChecks.reachability?.status === 'checked' ? REACHABILITY_RULE_IDS : []),
270
- ...(hfsChecks.deadExports?.status === 'checked' ? DEAD_EXPORT_RULE_IDS : []),
271
- ...(hfsChecks.requiredFiles?.status === 'checked' ? REQUIRED_FILE_RULE_IDS : []),
272
- ...(hfsChecks.clones?.status === 'checked' ? CLONE_RULE_IDS : []),
273
- ...(hfsChecks.symbols?.status === 'checked' ? SYMBOL_RULE_IDS : []),
274
- ...(hfsChecks.docLanguage?.status === 'checked' ? DOC_LANGUAGE_RULE_IDS : []),
275
- ];
264
+ return [
265
+ ...(hfsChecks.tiers ? TIER_RULE_IDS : []),
266
+ ...(hfsChecks.reachability?.status === 'checked' ? REACHABILITY_RULE_IDS : []),
267
+ ...(hfsChecks.deadExports?.status === 'checked' ? DEAD_EXPORT_RULE_IDS : []),
268
+ ...(hfsChecks.requiredFiles?.status === 'checked' ? REQUIRED_FILE_RULE_IDS : []),
269
+ ...(hfsChecks.clones?.status === 'checked' ? CLONE_RULE_IDS : []),
270
+ ...(hfsChecks.symbols?.status === 'checked' ? SYMBOL_RULE_IDS : []),
271
+ ...(hfsChecks.docLanguage?.status === 'checked' ? DOC_LANGUAGE_RULE_IDS : []),
272
+ ];
276
273
  }
277
-
278
274
  function derivedCoverageRuleIds(coverage) {
279
- return [
280
- ...(coverage.ownerPublicApi.status === 'checked' ? OWNER_RULE_IDS : []),
281
- ...(coverage.grammarContract.status === 'checked' ? GRAMMAR_RULE_IDS : []),
282
- ...(coverage.moduleRegistration.status === 'checked' ? REGISTRATION_RULE_IDS : []),
283
- ...(coverage.backendSourceShape.layout?.status === 'checked' ? [SOURCE_LAYOUT_RULE_ID] : []),
284
- ...(coverage.backendSourceShape.naming?.status === 'checked' ? [SOURCE_NAME_RULE_ID] : []),
285
- ...(coverage.backendContractTypeForm.publicContracts?.status === 'checked' ? [PUBLIC_CONTRACT_RULE_ID] : []),
286
- ...(coverage.backendContractTypeForm.readonlyBoundaries?.status === 'checked' ? [READONLY_BOUNDARY_RULE_ID] : []),
287
- ];
275
+ return [
276
+ ...(coverage.ownerPublicApi.status === 'checked' ? OWNER_RULE_IDS : []),
277
+ ...(coverage.grammarContract.status === 'checked' ? GRAMMAR_RULE_IDS : []),
278
+ ...(coverage.moduleRegistration.status === 'checked' ? REGISTRATION_RULE_IDS : []),
279
+ ...(coverage.backendSourceShape.layout?.status === 'checked' ? [SOURCE_LAYOUT_RULE_ID] : []),
280
+ ...(coverage.backendSourceShape.naming?.status === 'checked' ? [SOURCE_NAME_RULE_ID] : []),
281
+ ...(coverage.backendContractTypeForm.publicContracts?.status === 'checked' ? [PUBLIC_CONTRACT_RULE_ID] : []),
282
+ ...(coverage.backendContractTypeForm.readonlyBoundaries?.status === 'checked' ? [READONLY_BOUNDARY_RULE_ID] : []),
283
+ ];
288
284
  }
289
-
290
285
  function checkedRuleIdsFor(config, hfs, hfsChecks, frontendChecked, coverage) {
291
- const machineRuleIds = Object.entries({ ...BACKEND_MACHINE, ...FRONTEND_MACHINE })
292
- .flatMap(([name, [, ids]]) => (hfsChecks[name]?.status === 'checked' ? ids : []));
293
- const checked = [...new Set([
294
- ...COMMON_RULE_IDS,
295
- ...hfsRuleIds(hfs),
296
- ...(config.kinds.includes('backend') ? BACKEND_RULE_IDS : []),
297
- ...hfsCheckRuleIds(hfsChecks),
298
- ...CONFIG_UNREAD_RULE_IDS,
299
- ...machineRuleIds,
300
- ...(frontendChecked ? FRONTEND_RULE_IDS : []),
301
- ...derivedCoverageRuleIds(coverage),
302
- ...(config.kinds.includes('frontend') && ['checked', 'not-applicable'].includes(coverage.frontendDataLifecycle.status) ? SWR_DATA_RULE_IDS : []),
303
- ])];
304
- return checked.filter(id => !(id.startsWith('FE_') && !config.kinds.includes('frontend')) && !(id.startsWith('BE_') && !config.kinds.includes('backend')))
305
- .sort(byCodeUnit);
286
+ const machineRuleIds = Object.entries({ ...BACKEND_MACHINE, ...FRONTEND_MACHINE })
287
+ .flatMap(([name, [, ids]]) => (hfsChecks[name]?.status === 'checked' ? ids : []));
288
+ const checked = [...new Set([
289
+ ...COMMON_RULE_IDS,
290
+ ...hfsRuleIds(hfs),
291
+ ...(config.kinds.includes('backend') ? BACKEND_RULE_IDS : []),
292
+ ...hfsCheckRuleIds(hfsChecks),
293
+ ...CONFIG_UNREAD_RULE_IDS,
294
+ ...machineRuleIds,
295
+ ...(frontendChecked ? FRONTEND_RULE_IDS : []),
296
+ ...derivedCoverageRuleIds(coverage),
297
+ ...(config.kinds.includes('frontend') && ['checked', 'not-applicable'].includes(coverage.frontendDataLifecycle.status) ? SWR_DATA_RULE_IDS : []),
298
+ ])];
299
+ return checked.filter(id => !(id.startsWith('FE_') && !config.kinds.includes('frontend')) && !(id.startsWith('BE_') && !config.kinds.includes('backend')))
300
+ .sort(byCodeUnit);
306
301
  }
307
-
308
302
  /** The errors and the violations a surface reports: findings under the requested paths, on the requested surface, in stable order. */
309
303
  function scopeFindings({ config, context, violations, paths, surface }) {
310
- const inScope = item => !paths.length || (item.path && paths.some(prefix => sameOrUnder(item.path, prefix.replace(/\/$/, ''))));
311
- // Two findings travel as context errors (package boundary edges); they are obligations of the lint surface like any other finding.
312
- const asViolation = item => LINT_CODES.has(item.ruleId);
313
- const allErrors = context.errors.filter(item => item.ruleId.startsWith('ARCH_TSCONFIG_') || !item.path || inScope(item));
314
- const obligations = surface === 'all' ? violations : [...violations, ...context.errors.filter(asViolation).filter(inScope)];
315
- // The lint surface is what an editor can show on a line of a TypeScript file; `starci app check` keeps every other finding of the machine.
316
- const onSurface = item => surface === 'all' || onLintSurface(config.root, item) === (surface === 'lint');
317
- const errors = stable(surface === 'all' ? allErrors : allErrors.filter(item => !asViolation(item)));
318
- const scopedViolations = stable(obligations.filter(inScope).filter(onSurface));
319
- return { errors, scopedViolations };
304
+ const inScope = (item) => {
305
+ const itemPath = item.path;
306
+ return !paths.length || Boolean(itemPath && paths.some(prefix => sameOrUnder(itemPath, prefix.replace(/\/$/, ''))));
307
+ };
308
+ // Two findings travel as context errors (package boundary edges); they are obligations of the lint surface like any other finding.
309
+ const asViolation = (item) => LINT_CODES.has(item.ruleId);
310
+ const allErrors = context.errors.filter(item => item.ruleId.startsWith('ARCH_TSCONFIG_') || !item.path || inScope(item));
311
+ const obligations = surface === 'all' ? violations : [...violations, ...context.errors.filter(asViolation).filter(inScope)];
312
+ // The lint surface is what an editor can show on a line of a TypeScript file; `starci app check` keeps every other finding of the machine.
313
+ const onSurface = (item) => surface === 'all' || onLintSurface(config.root, item) === (surface === 'lint');
314
+ const errors = stable(surface === 'all' ? allErrors : allErrors.filter(item => !asViolation(item)));
315
+ const scopedViolations = stable(obligations.filter(inScope).filter(onSurface));
316
+ return { errors, scopedViolations };
320
317
  }
321
-
322
318
  /**
323
319
  * Check a target repository. injectedTypeScript exists only for hermetic rule fixtures. `fast` leaves out the checks
324
320
  * that read the whole repository to answer (clones, dead exports, repository-wide symbols); the pre-push check of the changed owners uses it.
325
321
  */
326
322
  export function checkArchitecture(options = {}) {
327
- return withTypeScriptProgramRun(() => withTreeCache(() => checkArchitectureOnce(options)));
323
+ return withTypeScriptProgramRun(() => withTreeCache(() => checkArchitectureOnce(options)));
328
324
  }
329
-
330
325
  function checkArchitectureOnce({ repositoryRoot, injectedTypeScript, paths = [], base, fast = false, hfs: openedHfs, surface = 'all' }) {
331
- if (!['all', 'lint', 'check'].includes(surface)) throw new Error(`unknown surface ${surface}`);
332
- let config;
333
- try {
334
- config = loadArchitectureConfig(repositoryRoot, { hfs: openedHfs });
335
- } catch (error) {
336
- return invalidConfigurationResult(repositoryRoot, error);
337
- }
338
- const hfs = checkHfs(config);
339
- let context;
340
- try {
341
- context = buildTypeScriptContext(config, injectedTypeScript, paths);
342
- } catch (error) {
343
- return compilerFailureResult(config, hfs, error);
344
- }
345
- const violations = [...hfs.violations];
346
- const configUnread = checkConfigUnread({ context });
347
- violations.push(...configUnread.violations);
348
- let moduleRegistration = { status: 'not-applicable' };
349
- let backendSourceShape = { status: 'not-applicable' };
350
- let backendContractTypeForm = { publicContracts: { status: 'not-applicable' }, readonlyBoundaries: { status: 'not-applicable' } };
351
- let frontendDataLifecycle = { status: 'not-applicable' };
352
- if (context.program) violations.push(...checkOwners(config, context));
353
- if (context.program && config.kinds.includes('backend')) {
354
- const backend = runBackendChecks(config, context, paths, injectedTypeScript, violations);
355
- moduleRegistration = backend.moduleRegistration;
356
- backendSourceShape = backend.backendSourceShape;
357
- backendContractTypeForm = backend.backendContractTypeForm;
358
- }
359
- let frontendChecked = config.kinds.includes('frontend');
360
- if (context.program && config.kinds.includes('frontend')) {
361
- // A broken authored input (the framework-pinned root list in knowledge) is an error, never a
362
- // silently different contract: the frontend rules are then not reported as checked.
363
- const frontend = runFrontendChecks(config, context, violations);
364
- frontendChecked = frontend.frontendChecked;
365
- frontendDataLifecycle = frontend.frontendDataLifecycle;
366
- }
367
- const hfsChecks = runHfsMachine(config, context, paths, injectedTypeScript, base, fast, violations);
368
- const { errors, scopedViolations } = scopeFindings({ config, context, violations, paths, surface });
369
- const sourceFiles = new Set(context.files.map(file => canonical(file.fileName)));
370
- const missingOwnerEntries = config.owners?.filter(owner => !sourceFiles.has(canonical(path.resolve(config.root, ...owner.entry.split('/'))))) ?? [];
371
- const coverage = {
372
- sourceFiles: context.files.map(file => relativePath(config.root, canonical(file.fileName))).sort(byCodeUnit),
373
- hfs: hfs.coverage,
374
- configUnread: configUnread.coverage,
375
- backendContractTypeForm,
376
- backendSourceShape,
377
- frontendDataLifecycle,
378
- moduleRegistration,
379
- hfsMachine: hfsChecks,
380
- ownerPublicApi: ownerPublicApiOf(config.owners, missingOwnerEntries),
381
- grammarContract: grammarContractOf(config),
382
- };
383
- coverage.checkedRuleIds = checkedRuleIdsFor(config, hfs, hfsChecks, frontendChecked, coverage);
384
- return {
385
- schema: 'starci/architecture-check@1',
386
- ok: errors.length === 0 && scopedViolations.length === 0,
387
- repository: config.root,
388
- kinds: config.kinds,
389
- files: context.files.length,
390
- compiler: { version: context.loaded.version, resolved: context.loaded.resolved, projects: context.projects.map(item => item.relative) },
391
- coverage,
392
- violations: scopedViolations,
393
- errors,
394
- limitations: LIMITATIONS,
395
- };
326
+ if (!['all', 'lint', 'check'].includes(surface))
327
+ throw new Error(`unknown surface ${surface}`);
328
+ let config;
329
+ try {
330
+ // an absent root reaches path.resolve, which throws and is reported as an invalid configuration
331
+ config = loadArchitectureConfig(repositoryRoot, { hfs: openedHfs });
332
+ }
333
+ catch (error) {
334
+ return invalidConfigurationResult(repositoryRoot, error);
335
+ }
336
+ const hfs = checkHfs(config);
337
+ let context;
338
+ try {
339
+ context = buildTypeScriptContext(config, injectedTypeScript, paths);
340
+ }
341
+ catch (error) {
342
+ return compilerFailureResult(config, hfs, error);
343
+ }
344
+ const violations = [...hfs.violations];
345
+ const configUnread = checkConfigUnread({ context });
346
+ violations.push(...configUnread.violations);
347
+ let moduleRegistration = { status: 'not-applicable' };
348
+ let backendSourceShape = { status: 'not-applicable' };
349
+ let backendContractTypeForm = { publicContracts: { status: 'not-applicable' }, readonlyBoundaries: { status: 'not-applicable' } };
350
+ let frontendDataLifecycle = { status: 'not-applicable' };
351
+ if (context.program)
352
+ violations.push(...checkOwners(config, context));
353
+ if (context.program && config.kinds.includes('backend')) {
354
+ const backend = runBackendChecks(config, context, paths, injectedTypeScript, violations);
355
+ moduleRegistration = backend.moduleRegistration;
356
+ backendSourceShape = backend.backendSourceShape;
357
+ backendContractTypeForm = backend.backendContractTypeForm;
358
+ }
359
+ let frontendChecked = config.kinds.includes('frontend');
360
+ if (context.program && config.kinds.includes('frontend')) {
361
+ // A broken authored input (the framework-pinned root list in knowledge) is an error, never a
362
+ // silently different contract: the frontend rules are then not reported as checked.
363
+ const frontend = runFrontendChecks(config, context, violations);
364
+ frontendChecked = frontend.frontendChecked;
365
+ frontendDataLifecycle = frontend.frontendDataLifecycle;
366
+ }
367
+ const hfsChecks = runHfsMachine(config, context, paths, injectedTypeScript, base, fast, violations);
368
+ const { errors, scopedViolations } = scopeFindings({ config, context, violations, paths, surface });
369
+ const sourceFiles = new Set(context.files.map(file => canonical(file.fileName)));
370
+ const missingOwnerEntries = config.owners?.filter(owner => !sourceFiles.has(canonical(path.resolve(config.root, ...owner.entry.split('/'))))) ?? [];
371
+ const coverage = {
372
+ sourceFiles: context.files.map(file => relativePath(config.root, canonical(file.fileName))).sort(byCodeUnit),
373
+ hfs: hfs.coverage,
374
+ configUnread: configUnread.coverage,
375
+ backendContractTypeForm,
376
+ backendSourceShape,
377
+ frontendDataLifecycle,
378
+ moduleRegistration,
379
+ hfsMachine: hfsChecks,
380
+ ownerPublicApi: ownerPublicApiOf(config.owners, missingOwnerEntries),
381
+ grammarContract: grammarContractOf(config),
382
+ };
383
+ coverage.checkedRuleIds = checkedRuleIdsFor(config, hfs, hfsChecks, frontendChecked, coverage);
384
+ return {
385
+ schema: 'starci/architecture-check@1',
386
+ ok: errors.length === 0 && scopedViolations.length === 0,
387
+ repository: config.root,
388
+ kinds: config.kinds,
389
+ files: context.files.length,
390
+ compiler: { version: context.loaded.version, resolved: context.loaded.resolved, projects: context.projects.map(item => item.relative) },
391
+ coverage,
392
+ violations: scopedViolations,
393
+ errors,
394
+ limitations: LIMITATIONS,
395
+ };
396
396
  }