@shivaedev/quality 0.75.0 → 0.77.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 (674) hide show
  1. package/CHANGELOG.md +68 -0
  2. package/README.md +66 -60
  3. package/dist/adapters/biome/pluginContract.d.ts +1 -1
  4. package/dist/adapters/biome/pluginContract.d.ts.map +1 -1
  5. package/dist/adapters/biome/pluginContract.js +2 -5
  6. package/dist/adapters/biome/pluginContract.js.map +1 -1
  7. package/dist/adapters/biome/run.d.ts.map +1 -1
  8. package/dist/adapters/biome/run.js +2 -0
  9. package/dist/adapters/biome/run.js.map +1 -1
  10. package/dist/adapters/biome/withExceptionConfig.d.ts.map +1 -1
  11. package/dist/adapters/biome/withExceptionConfig.js +21 -4
  12. package/dist/adapters/biome/withExceptionConfig.js.map +1 -1
  13. package/dist/adapters/changeKeyCheck.d.ts +10 -0
  14. package/dist/adapters/changeKeyCheck.d.ts.map +1 -0
  15. package/dist/adapters/{changeKeyFindings.js → changeKeyCheck.js} +8 -22
  16. package/dist/adapters/changeKeyCheck.js.map +1 -0
  17. package/dist/adapters/commandLine.d.ts +2 -0
  18. package/dist/adapters/commandLine.d.ts.map +1 -1
  19. package/dist/adapters/contextCaptureCheck.d.ts +9 -0
  20. package/dist/adapters/contextCaptureCheck.d.ts.map +1 -0
  21. package/dist/adapters/contextCaptureCheck.js +91 -0
  22. package/dist/adapters/contextCaptureCheck.js.map +1 -0
  23. package/dist/adapters/databaseUrlFindings.d.ts +1 -1
  24. package/dist/adapters/databaseUrlFindings.d.ts.map +1 -1
  25. package/dist/adapters/declaration-files/initialize.d.ts +6 -0
  26. package/dist/adapters/declaration-files/initialize.d.ts.map +1 -0
  27. package/dist/adapters/declaration-files/initialize.js +4 -0
  28. package/dist/adapters/declaration-files/initialize.js.map +1 -0
  29. package/dist/adapters/declaration-files/parse.d.ts +5 -0
  30. package/dist/adapters/declaration-files/parse.d.ts.map +1 -0
  31. package/dist/adapters/declaration-files/parse.js +6 -0
  32. package/dist/adapters/declaration-files/parse.js.map +1 -0
  33. package/dist/adapters/declaration-files/reader.d.ts +5 -0
  34. package/dist/adapters/declaration-files/reader.d.ts.map +1 -0
  35. package/dist/adapters/declaration-files/reader.js +23 -0
  36. package/dist/adapters/declaration-files/reader.js.map +1 -0
  37. package/dist/adapters/declaration-files/service.d.ts +9 -0
  38. package/dist/adapters/declaration-files/service.d.ts.map +1 -0
  39. package/dist/adapters/declaration-files/service.js +14 -0
  40. package/dist/adapters/declaration-files/service.js.map +1 -0
  41. package/dist/adapters/foreignResources.d.ts.map +1 -1
  42. package/dist/adapters/foreignResources.js +0 -4
  43. package/dist/adapters/foreignResources.js.map +1 -1
  44. package/dist/adapters/import-compiler/graph.d.ts +8 -2
  45. package/dist/adapters/import-compiler/graph.d.ts.map +1 -1
  46. package/dist/adapters/import-compiler/graph.js +4 -1
  47. package/dist/adapters/import-compiler/graph.js.map +1 -1
  48. package/dist/adapters/import-compiler/service.d.ts +7 -1
  49. package/dist/adapters/import-compiler/service.d.ts.map +1 -1
  50. package/dist/adapters/imports/graph.d.ts +6 -3
  51. package/dist/adapters/imports/graph.d.ts.map +1 -1
  52. package/dist/adapters/imports/graph.js +31 -18
  53. package/dist/adapters/imports/graph.js.map +1 -1
  54. package/dist/adapters/knip/configuration.d.ts +2 -2
  55. package/dist/adapters/knip/configuration.d.ts.map +1 -1
  56. package/dist/adapters/knip/configuration.js +11 -5
  57. package/dist/adapters/knip/configuration.js.map +1 -1
  58. package/dist/adapters/knip/entryPointFindings.d.ts +1 -1
  59. package/dist/adapters/knip/entryPointFindings.d.ts.map +1 -1
  60. package/dist/adapters/knip/run.d.ts +1 -1
  61. package/dist/adapters/knip/run.d.ts.map +1 -1
  62. package/dist/adapters/knip/run.js +4 -1
  63. package/dist/adapters/knip/run.js.map +1 -1
  64. package/dist/adapters/outsideImportFindings.d.ts +5 -2
  65. package/dist/adapters/outsideImportFindings.d.ts.map +1 -1
  66. package/dist/adapters/outsideImportFindings.js +12 -52
  67. package/dist/adapters/outsideImportFindings.js.map +1 -1
  68. package/dist/adapters/queueReadoutFindings.d.ts +1 -1
  69. package/dist/adapters/queueReadoutFindings.d.ts.map +1 -1
  70. package/dist/adapters/rule.d.ts +9 -1
  71. package/dist/adapters/rule.d.ts.map +1 -1
  72. package/dist/adapters/rule.js +21 -6
  73. package/dist/adapters/rule.js.map +1 -1
  74. package/dist/adapters/runMain.d.ts +3 -4
  75. package/dist/adapters/runMain.d.ts.map +1 -1
  76. package/dist/adapters/runMain.js +2 -1
  77. package/dist/adapters/runMain.js.map +1 -1
  78. package/dist/adapters/serviceIdFindings.d.ts +1 -1
  79. package/dist/adapters/serviceIdFindings.d.ts.map +1 -1
  80. package/dist/adapters/serviceModelCheck.d.ts +9 -0
  81. package/dist/adapters/serviceModelCheck.d.ts.map +1 -0
  82. package/dist/adapters/{serviceModelFindings.js → serviceModelCheck.js} +9 -23
  83. package/dist/adapters/serviceModelCheck.js.map +1 -0
  84. package/dist/adapters/sharedErrorCatalog.d.ts +13 -0
  85. package/dist/adapters/sharedErrorCatalog.d.ts.map +1 -0
  86. package/dist/adapters/sharedErrorCatalog.js +28 -0
  87. package/dist/adapters/sharedErrorCatalog.js.map +1 -0
  88. package/dist/adapters/sharedErrorModules.d.ts +1 -1
  89. package/dist/adapters/sharedErrorModules.d.ts.map +1 -1
  90. package/dist/adapters/sharedErrorModules.js.map +1 -1
  91. package/dist/adapters/specReaderSources.d.ts +3 -2
  92. package/dist/adapters/specReaderSources.d.ts.map +1 -1
  93. package/dist/adapters/specReaderSources.js +6 -3
  94. package/dist/adapters/specReaderSources.js.map +1 -1
  95. package/dist/adapters/storyProgram.d.ts +2 -0
  96. package/dist/adapters/storyProgram.d.ts.map +1 -1
  97. package/dist/adapters/storyProgram.js +13 -3
  98. package/dist/adapters/storyProgram.js.map +1 -1
  99. package/dist/adapters/typeScriptProgram.d.ts +5 -0
  100. package/dist/adapters/typeScriptProgram.d.ts.map +1 -0
  101. package/dist/adapters/typeScriptProgram.js +43 -0
  102. package/dist/adapters/typeScriptProgram.js.map +1 -0
  103. package/dist/baseline/compare.d.ts +2 -0
  104. package/dist/baseline/compare.d.ts.map +1 -1
  105. package/dist/baseline/compare.js +43 -17
  106. package/dist/baseline/compare.js.map +1 -1
  107. package/dist/baseline/format.d.ts +1 -0
  108. package/dist/baseline/format.d.ts.map +1 -1
  109. package/dist/baseline/format.js +6 -2
  110. package/dist/baseline/format.js.map +1 -1
  111. package/dist/baseline/merge.d.ts.map +1 -1
  112. package/dist/baseline/merge.js +14 -1
  113. package/dist/baseline/merge.js.map +1 -1
  114. package/dist/baseline/rewrite.d.ts.map +1 -1
  115. package/dist/baseline/rewrite.js +3 -1
  116. package/dist/baseline/rewrite.js.map +1 -1
  117. package/dist/baseline/update.d.ts +7 -0
  118. package/dist/baseline/update.d.ts.map +1 -1
  119. package/dist/baseline/update.js +29 -8
  120. package/dist/baseline/update.js.map +1 -1
  121. package/dist/biome/exceptionConfig.d.ts +3 -0
  122. package/dist/biome/exceptionConfig.d.ts.map +1 -1
  123. package/dist/biome/exceptionConfig.js +15 -1
  124. package/dist/biome/exceptionConfig.js.map +1 -1
  125. package/dist/biome/scannerRules.d.ts +3 -0
  126. package/dist/biome/scannerRules.d.ts.map +1 -0
  127. package/dist/biome/scannerRules.js +42 -0
  128. package/dist/biome/scannerRules.js.map +1 -0
  129. package/dist/cli/args.d.ts +2 -0
  130. package/dist/cli/args.d.ts.map +1 -1
  131. package/dist/cli/args.js +10 -1
  132. package/dist/cli/args.js.map +1 -1
  133. package/dist/cli/baseline.d.ts.map +1 -1
  134. package/dist/cli/baseline.js +5 -1
  135. package/dist/cli/baseline.js.map +1 -1
  136. package/dist/cli/lint.d.ts +9 -1
  137. package/dist/cli/lint.d.ts.map +1 -1
  138. package/dist/cli/lint.js +18 -5
  139. package/dist/cli/lint.js.map +1 -1
  140. package/dist/cli/migrateExceptions.d.ts.map +1 -1
  141. package/dist/cli/migrateExceptions.js +5 -8
  142. package/dist/cli/migrateExceptions.js.map +1 -1
  143. package/dist/cli/misplaced.d.ts +6 -0
  144. package/dist/cli/misplaced.d.ts.map +1 -1
  145. package/dist/cli/misplaced.js +4 -2
  146. package/dist/cli/misplaced.js.map +1 -1
  147. package/dist/cli/program.js +1 -1
  148. package/dist/cli/program.js.map +1 -1
  149. package/dist/cli/runSet.d.ts +5 -0
  150. package/dist/cli/runSet.d.ts.map +1 -0
  151. package/dist/cli/runSet.js +15 -0
  152. package/dist/cli/runSet.js.map +1 -0
  153. package/dist/cli/shrink.d.ts +4 -4
  154. package/dist/cli/shrink.d.ts.map +1 -1
  155. package/dist/cli/shrink.js.map +1 -1
  156. package/dist/cli/usage.d.ts +1 -1
  157. package/dist/cli/usage.d.ts.map +1 -1
  158. package/dist/cli/usage.js +7 -2
  159. package/dist/cli/usage.js.map +1 -1
  160. package/dist/config/decode.d.ts +1 -0
  161. package/dist/config/decode.d.ts.map +1 -1
  162. package/dist/config/decode.js +1 -0
  163. package/dist/config/decode.js.map +1 -1
  164. package/dist/config/load.d.ts +2 -0
  165. package/dist/config/load.d.ts.map +1 -1
  166. package/dist/config/load.js +1 -0
  167. package/dist/config/load.js.map +1 -1
  168. package/dist/config/resolve.d.ts +2 -1
  169. package/dist/config/resolve.d.ts.map +1 -1
  170. package/dist/config/resolve.js +9 -4
  171. package/dist/config/resolve.js.map +1 -1
  172. package/dist/config.d.ts +2 -0
  173. package/dist/config.d.ts.map +1 -1
  174. package/dist/config.js.map +1 -1
  175. package/dist/engine/childStarted.d.ts +4 -0
  176. package/dist/engine/childStarted.d.ts.map +1 -0
  177. package/dist/engine/childStarted.js +7 -0
  178. package/dist/engine/childStarted.js.map +1 -0
  179. package/dist/engine/evaluate.d.ts +1 -0
  180. package/dist/engine/evaluate.d.ts.map +1 -1
  181. package/dist/engine/evaluate.js +2 -1
  182. package/dist/engine/evaluate.js.map +1 -1
  183. package/dist/engine/runRule.d.ts +21 -0
  184. package/dist/engine/runRule.d.ts.map +1 -0
  185. package/dist/engine/runRule.js +70 -0
  186. package/dist/engine/runRule.js.map +1 -0
  187. package/dist/engine/runRules.d.ts +5 -12
  188. package/dist/engine/runRules.d.ts.map +1 -1
  189. package/dist/engine/runRules.js +49 -65
  190. package/dist/engine/runRules.js.map +1 -1
  191. package/dist/engine/session.d.ts +2 -1
  192. package/dist/engine/session.d.ts.map +1 -1
  193. package/dist/engine/session.js +20 -6
  194. package/dist/engine/session.js.map +1 -1
  195. package/dist/engine/violation.d.ts +7 -0
  196. package/dist/engine/violation.d.ts.map +1 -1
  197. package/dist/engine/violation.js +9 -0
  198. package/dist/engine/violation.js.map +1 -1
  199. package/dist/exceptions/MigrationFailure.d.ts +9 -0
  200. package/dist/exceptions/MigrationFailure.d.ts.map +1 -0
  201. package/dist/exceptions/MigrationFailure.js +4 -0
  202. package/dist/exceptions/MigrationFailure.js.map +1 -0
  203. package/dist/exceptions/biomeFindings.d.ts +5 -1
  204. package/dist/exceptions/biomeFindings.d.ts.map +1 -1
  205. package/dist/exceptions/biomeFindings.js +17 -18
  206. package/dist/exceptions/biomeFindings.js.map +1 -1
  207. package/dist/exceptions/migrateBiome.d.ts +3 -1
  208. package/dist/exceptions/migrateBiome.d.ts.map +1 -1
  209. package/dist/exceptions/migrateBiome.js +5 -3
  210. package/dist/exceptions/migrateBiome.js.map +1 -1
  211. package/dist/exceptions/migrateConfig.d.ts +3 -1
  212. package/dist/exceptions/migrateConfig.d.ts.map +1 -1
  213. package/dist/exceptions/migrateConfig.js +40 -25
  214. package/dist/exceptions/migrateConfig.js.map +1 -1
  215. package/dist/exceptions/registry.d.ts.map +1 -1
  216. package/dist/exceptions/registry.js +2 -2
  217. package/dist/exceptions/registry.js.map +1 -1
  218. package/dist/hooks/preCommit.d.ts +1 -2
  219. package/dist/hooks/preCommit.d.ts.map +1 -1
  220. package/dist/hooks/preCommit.js +18 -4
  221. package/dist/hooks/preCommit.js.map +1 -1
  222. package/dist/hooks/stagedCheck.d.ts +5 -0
  223. package/dist/hooks/stagedCheck.d.ts.map +1 -0
  224. package/dist/hooks/stagedCheck.js +43 -0
  225. package/dist/hooks/stagedCheck.js.map +1 -0
  226. package/dist/hooks/withStagedContent.d.ts +5 -0
  227. package/dist/hooks/withStagedContent.d.ts.map +1 -0
  228. package/dist/hooks/withStagedContent.js +84 -0
  229. package/dist/hooks/withStagedContent.js.map +1 -0
  230. package/dist/imports/browserGlobals.d.ts +1 -1
  231. package/dist/imports/browserGlobals.d.ts.map +1 -1
  232. package/dist/imports/browserNames.d.ts +1 -1
  233. package/dist/imports/browserNames.d.ts.map +1 -1
  234. package/dist/imports/browserNames.js +5 -3
  235. package/dist/imports/browserNames.js.map +1 -1
  236. package/dist/imports/departures.d.ts +1 -1
  237. package/dist/imports/departures.d.ts.map +1 -1
  238. package/dist/imports/fences/check.d.ts +1 -1
  239. package/dist/imports/fences/check.d.ts.map +1 -1
  240. package/dist/imports/fences/check.js +1 -1
  241. package/dist/imports/fences/check.js.map +1 -1
  242. package/dist/imports/fences/compilePolicy.d.ts +3 -1
  243. package/dist/imports/fences/compilePolicy.d.ts.map +1 -1
  244. package/dist/imports/fences/compilePolicy.js +5 -3
  245. package/dist/imports/fences/compilePolicy.js.map +1 -1
  246. package/dist/imports/fences/evaluate.d.ts +1 -1
  247. package/dist/imports/fences/evaluate.d.ts.map +1 -1
  248. package/dist/imports/fences/evaluate.js +1 -1
  249. package/dist/imports/fences/evaluate.js.map +1 -1
  250. package/dist/imports/globMatcher.d.ts.map +1 -1
  251. package/dist/imports/globMatcher.js +33 -31
  252. package/dist/imports/globMatcher.js.map +1 -1
  253. package/dist/imports/graph.d.ts +6 -1
  254. package/dist/imports/graph.d.ts.map +1 -1
  255. package/dist/imports/graph.js +30 -2
  256. package/dist/imports/graph.js.map +1 -1
  257. package/dist/imports/pnpmWorkspacePatterns.d.ts +12 -2
  258. package/dist/imports/pnpmWorkspacePatterns.d.ts.map +1 -1
  259. package/dist/imports/pnpmWorkspacePatterns.js +31 -32
  260. package/dist/imports/pnpmWorkspacePatterns.js.map +1 -1
  261. package/dist/imports/withoutGenerated.js +1 -1
  262. package/dist/imports/withoutGenerated.js.map +1 -1
  263. package/dist/imports/workspace.d.ts +1 -1
  264. package/dist/imports/workspace.d.ts.map +1 -1
  265. package/dist/imports/workspace.js +1 -1
  266. package/dist/imports/workspace.js.map +1 -1
  267. package/dist/inventory/programmaticBuilds.d.ts +1 -1
  268. package/dist/inventory/programmaticBuilds.d.ts.map +1 -1
  269. package/dist/inventory/trackedPaths.d.ts +1 -0
  270. package/dist/inventory/trackedPaths.d.ts.map +1 -1
  271. package/dist/inventory/trackedPaths.js +9 -3
  272. package/dist/inventory/trackedPaths.js.map +1 -1
  273. package/dist/manifests/deliveredDependencies.d.ts +3 -0
  274. package/dist/manifests/deliveredDependencies.d.ts.map +1 -0
  275. package/dist/manifests/deliveredDependencies.js +8 -0
  276. package/dist/manifests/deliveredDependencies.js.map +1 -0
  277. package/dist/naming/developmentCode.d.ts +1 -1
  278. package/dist/naming/developmentCode.d.ts.map +1 -1
  279. package/dist/naming/packageTests.d.ts +1 -1
  280. package/dist/naming/packageTests.d.ts.map +1 -1
  281. package/dist/naming/testCode.d.ts +1 -1
  282. package/dist/naming/testCode.d.ts.map +1 -1
  283. package/dist/report/recap.d.ts +4 -0
  284. package/dist/report/recap.d.ts.map +1 -0
  285. package/dist/report/recap.js +23 -0
  286. package/dist/report/recap.js.map +1 -0
  287. package/dist/report/render.d.ts +2 -0
  288. package/dist/report/render.d.ts.map +1 -1
  289. package/dist/report/render.js +11 -4
  290. package/dist/report/render.js.map +1 -1
  291. package/dist/report/runSetLine.d.ts +3 -0
  292. package/dist/report/runSetLine.d.ts.map +1 -0
  293. package/dist/report/runSetLine.js +13 -0
  294. package/dist/report/runSetLine.js.map +1 -0
  295. package/dist/report/staleSections.d.ts.map +1 -1
  296. package/dist/report/staleSections.js +13 -0
  297. package/dist/report/staleSections.js.map +1 -1
  298. package/dist/rule.d.ts +30 -4
  299. package/dist/rule.d.ts.map +1 -1
  300. package/dist/rule.js +4 -2
  301. package/dist/rule.js.map +1 -1
  302. package/dist/rules/biome.d.ts +18 -1
  303. package/dist/rules/biome.d.ts.map +1 -1
  304. package/dist/rules/biome.js +32 -7
  305. package/dist/rules/biome.js.map +1 -1
  306. package/dist/rules/builtIn.d.ts +8 -8
  307. package/dist/rules/builtIn.d.ts.map +1 -1
  308. package/dist/rules/builtIn.js +0 -2
  309. package/dist/rules/builtIn.js.map +1 -1
  310. package/dist/rules/effect/adapterImports.d.ts +1 -1
  311. package/dist/rules/effect/adapterImports.d.ts.map +1 -1
  312. package/dist/rules/effect/adapterImports.js +1 -1
  313. package/dist/rules/effect/adapterImports.js.map +1 -1
  314. package/dist/rules/effect/boundary.d.ts +1 -1
  315. package/dist/rules/effect/boundary.d.ts.map +1 -1
  316. package/dist/rules/effect/boundary.js +60 -75
  317. package/dist/rules/effect/boundary.js.map +1 -1
  318. package/dist/rules/effect/boundaryFindings.d.ts +4 -0
  319. package/dist/rules/effect/boundaryFindings.d.ts.map +1 -0
  320. package/dist/rules/effect/boundaryFindings.js +63 -0
  321. package/dist/rules/effect/boundaryFindings.js.map +1 -0
  322. package/dist/rules/effect/boundaryReference.d.ts +4 -0
  323. package/dist/rules/effect/boundaryReference.d.ts.map +1 -1
  324. package/dist/rules/effect/boundaryReference.js +6 -3
  325. package/dist/rules/effect/boundaryReference.js.map +1 -1
  326. package/dist/rules/effect/contextCapture.d.ts.map +1 -1
  327. package/dist/rules/effect/contextCapture.js +3 -2
  328. package/dist/rules/effect/contextCapture.js.map +1 -1
  329. package/dist/rules/effect/errorTags.d.ts +10 -0
  330. package/dist/rules/effect/errorTags.d.ts.map +1 -0
  331. package/dist/rules/effect/errorTags.js +57 -0
  332. package/dist/rules/effect/errorTags.js.map +1 -0
  333. package/dist/rules/effect/failureHonesty.d.ts +1 -1
  334. package/dist/rules/effect/failureHonesty.d.ts.map +1 -1
  335. package/dist/rules/effect/failureHonesty.js +6 -5
  336. package/dist/rules/effect/failureHonesty.js.map +1 -1
  337. package/dist/rules/effect/policy.d.ts +1 -1
  338. package/dist/rules/effect/policy.d.ts.map +1 -1
  339. package/dist/rules/effect/policy.js +0 -2
  340. package/dist/rules/effect/policy.js.map +1 -1
  341. package/dist/rules/effect/promiseBridge.d.ts +3 -0
  342. package/dist/rules/effect/promiseBridge.d.ts.map +1 -0
  343. package/dist/rules/effect/promiseBridge.js +60 -0
  344. package/dist/rules/effect/promiseBridge.js.map +1 -0
  345. package/dist/rules/effect/rpcBoundary.d.ts.map +1 -1
  346. package/dist/rules/effect/rpcBoundary.js +92 -3
  347. package/dist/rules/effect/rpcBoundary.js.map +1 -1
  348. package/dist/rules/effect/serviceModel.d.ts.map +1 -1
  349. package/dist/rules/effect/serviceModel.js +3 -2
  350. package/dist/rules/effect/serviceModel.js.map +1 -1
  351. package/dist/rules/effect/serviceParameterCheck.d.ts +7 -0
  352. package/dist/rules/effect/serviceParameterCheck.d.ts.map +1 -0
  353. package/dist/rules/effect/serviceParameterCheck.js +15 -0
  354. package/dist/rules/effect/serviceParameterCheck.js.map +1 -0
  355. package/dist/rules/effect/serviceParameters.d.ts.map +1 -1
  356. package/dist/rules/effect/serviceParameters.js +4 -36
  357. package/dist/rules/effect/serviceParameters.js.map +1 -1
  358. package/dist/rules/effect/sharedErrorClasses.d.ts.map +1 -1
  359. package/dist/rules/effect/sharedErrorClasses.js +31 -2
  360. package/dist/rules/effect/sharedErrorClasses.js.map +1 -1
  361. package/dist/rules/effect/workspaceProgram.d.ts +5 -0
  362. package/dist/rules/effect/workspaceProgram.d.ts.map +1 -0
  363. package/dist/rules/effect/workspaceProgram.js +32 -0
  364. package/dist/rules/effect/workspaceProgram.js.map +1 -0
  365. package/dist/rules/imports/adminPaths.d.ts +1 -1
  366. package/dist/rules/imports/adminPaths.d.ts.map +1 -1
  367. package/dist/rules/imports/cycles.d.ts +1 -1
  368. package/dist/rules/imports/cycles.d.ts.map +1 -1
  369. package/dist/rules/imports/fences.d.ts +1 -1
  370. package/dist/rules/imports/fences.d.ts.map +1 -1
  371. package/dist/rules/imports/manifest.d.ts +1 -1
  372. package/dist/rules/imports/manifest.d.ts.map +1 -1
  373. package/dist/rules/imports/noTestCode.d.ts +1 -1
  374. package/dist/rules/imports/noTestCode.d.ts.map +1 -1
  375. package/dist/rules/imports/runtime.d.ts +1 -1
  376. package/dist/rules/imports/runtime.d.ts.map +1 -1
  377. package/dist/rules/imports/runtime.js +32 -5
  378. package/dist/rules/imports/runtime.js.map +1 -1
  379. package/dist/rules/manifestsApplication.d.ts.map +1 -1
  380. package/dist/rules/manifestsApplication.js +4 -5
  381. package/dist/rules/manifestsApplication.js.map +1 -1
  382. package/dist/rules/manifestsNoTestKits.js +1 -1
  383. package/dist/rules/manifestsNoTestKits.js.map +1 -1
  384. package/dist/rules/maxLines.d.ts +1 -1
  385. package/dist/rules/maxLines.d.ts.map +1 -1
  386. package/dist/rules/packageFindings.d.ts +31 -0
  387. package/dist/rules/packageFindings.d.ts.map +1 -0
  388. package/dist/rules/packageFindings.js +65 -0
  389. package/dist/rules/packageFindings.js.map +1 -0
  390. package/dist/rules/parse.d.ts +4 -1
  391. package/dist/rules/parse.d.ts.map +1 -1
  392. package/dist/rules/parse.js +35 -2
  393. package/dist/rules/parse.js.map +1 -1
  394. package/dist/rules/rootedFindings.d.ts +5 -0
  395. package/dist/rules/rootedFindings.d.ts.map +1 -0
  396. package/dist/rules/rootedFindings.js +16 -0
  397. package/dist/rules/rootedFindings.js.map +1 -0
  398. package/dist/rules/stories/adapterOnlyFakes.d.ts +1 -1
  399. package/dist/rules/stories/adapterOnlyFakes.d.ts.map +1 -1
  400. package/dist/rules/stories/adapterOnlyFakes.js +1 -0
  401. package/dist/rules/stories/adapterOnlyFakes.js.map +1 -1
  402. package/dist/rules/stories/databaseUrl.d.ts +1 -1
  403. package/dist/rules/stories/databaseUrl.d.ts.map +1 -1
  404. package/dist/rules/stories/databaseUrl.js +1 -0
  405. package/dist/rules/stories/databaseUrl.js.map +1 -1
  406. package/dist/rules/stories/domainOutcomes.d.ts +1 -1
  407. package/dist/rules/stories/domainOutcomes.d.ts.map +1 -1
  408. package/dist/rules/stories/domainOutcomes.js +1 -0
  409. package/dist/rules/stories/domainOutcomes.js.map +1 -1
  410. package/dist/rules/stories/engine.d.ts +1 -1
  411. package/dist/rules/stories/engine.d.ts.map +1 -1
  412. package/dist/rules/stories/engine.js +1 -0
  413. package/dist/rules/stories/engine.js.map +1 -1
  414. package/dist/rules/stories/globalRetries.d.ts +1 -1
  415. package/dist/rules/stories/globalRetries.d.ts.map +1 -1
  416. package/dist/rules/stories/globalRetries.js +1 -0
  417. package/dist/rules/stories/globalRetries.js.map +1 -1
  418. package/dist/rules/stories/groupedOutcomes.d.ts +1 -1
  419. package/dist/rules/stories/groupedOutcomes.d.ts.map +1 -1
  420. package/dist/rules/stories/groupedOutcomes.js +1 -0
  421. package/dist/rules/stories/groupedOutcomes.js.map +1 -1
  422. package/dist/rules/stories/importedChangeKeys.js +2 -2
  423. package/dist/rules/stories/importedChangeKeys.js.map +1 -1
  424. package/dist/rules/stories/namedValues.d.ts +1 -1
  425. package/dist/rules/stories/namedValues.d.ts.map +1 -1
  426. package/dist/rules/stories/namedValues.js +1 -0
  427. package/dist/rules/stories/namedValues.js.map +1 -1
  428. package/dist/rules/stories/noExpect.d.ts +1 -1
  429. package/dist/rules/stories/noExpect.d.ts.map +1 -1
  430. package/dist/rules/stories/noLimitImports.d.ts +1 -1
  431. package/dist/rules/stories/noLimitImports.d.ts.map +1 -1
  432. package/dist/rules/stories/noLimitImports.js +1 -0
  433. package/dist/rules/stories/noLimitImports.js.map +1 -1
  434. package/dist/rules/stories/positiveRefusals.d.ts +1 -1
  435. package/dist/rules/stories/positiveRefusals.d.ts.map +1 -1
  436. package/dist/rules/stories/positiveRefusals.js +1 -0
  437. package/dist/rules/stories/positiveRefusals.js.map +1 -1
  438. package/dist/rules/stories/queueReadouts.d.ts +1 -1
  439. package/dist/rules/stories/queueReadouts.d.ts.map +1 -1
  440. package/dist/rules/stories/queueReadouts.js +1 -0
  441. package/dist/rules/stories/queueReadouts.js.map +1 -1
  442. package/dist/rules/stories/sources.d.ts +2 -2
  443. package/dist/rules/stories/sources.d.ts.map +1 -1
  444. package/dist/rules/stories/specHelpers.d.ts +1 -1
  445. package/dist/rules/stories/specHelpers.d.ts.map +1 -1
  446. package/dist/rules/stories/specHelpers.js +3 -2
  447. package/dist/rules/stories/specHelpers.js.map +1 -1
  448. package/dist/rules/stories/specs.d.ts +1 -1
  449. package/dist/rules/stories/specs.d.ts.map +1 -1
  450. package/dist/rules/stories/specs.js +1 -0
  451. package/dist/rules/stories/specs.js.map +1 -1
  452. package/dist/rules/stories/waitOnEvents.d.ts +1 -1
  453. package/dist/rules/stories/waitOnEvents.d.ts.map +1 -1
  454. package/dist/rules/stories/waitOnEvents.js +3 -3
  455. package/dist/rules/stories/waitOnEvents.js.map +1 -1
  456. package/dist/rules/suppressions/noDoubleCast.d.ts.map +1 -1
  457. package/dist/rules/suppressions/noDoubleCast.js +4 -49
  458. package/dist/rules/suppressions/noDoubleCast.js.map +1 -1
  459. package/dist/rules/suppressions/typedCastCheck.d.ts +10 -0
  460. package/dist/rules/suppressions/typedCastCheck.d.ts.map +1 -0
  461. package/dist/rules/suppressions/typedCastCheck.js +48 -0
  462. package/dist/rules/suppressions/typedCastCheck.js.map +1 -0
  463. package/dist/rules/unusedCode.d.ts.map +1 -1
  464. package/dist/rules/unusedCode.js +1 -0
  465. package/dist/rules/unusedCode.js.map +1 -1
  466. package/dist/testing/adapters/cli.d.ts +1 -0
  467. package/dist/testing/adapters/cli.d.ts.map +1 -1
  468. package/dist/testing/adapters/cli.js +10 -8
  469. package/dist/testing/adapters/cli.js.map +1 -1
  470. package/dist/testing/adapters/git.d.ts +1 -16
  471. package/dist/testing/adapters/git.d.ts.map +1 -1
  472. package/dist/testing/adapters/git.js +5 -10
  473. package/dist/testing/adapters/git.js.map +1 -1
  474. package/dist/testing/adapters/hookRepository.d.ts +3 -2
  475. package/dist/testing/adapters/hookRepository.d.ts.map +1 -1
  476. package/dist/testing/adapters/hookRepository.js +11 -8
  477. package/dist/testing/adapters/hookRepository.js.map +1 -1
  478. package/dist/testing/adapters/imports.d.ts.map +1 -1
  479. package/dist/testing/adapters/imports.js +4 -1
  480. package/dist/testing/adapters/imports.js.map +1 -1
  481. package/dist/testing/ruleStory.d.ts +1 -1
  482. package/dist/testing/ruleStory.js +2 -2
  483. package/dist/testing/ruleStory.js.map +1 -1
  484. package/docs/debt-and-hooks.md +8 -4
  485. package/package.json +19 -19
  486. package/src/adapters/biome/pluginContract.ts +2 -5
  487. package/src/adapters/biome/run.ts +2 -0
  488. package/src/adapters/biome/withExceptionConfig.ts +26 -5
  489. package/src/adapters/{changeKeyFindings.ts → changeKeyCheck.ts} +8 -24
  490. package/src/adapters/contextCaptureCheck.ts +106 -0
  491. package/src/adapters/declaration-files/initialize.ts +4 -0
  492. package/src/adapters/declaration-files/parse.ts +9 -0
  493. package/src/adapters/declaration-files/reader.ts +28 -0
  494. package/src/adapters/declaration-files/service.ts +16 -0
  495. package/src/adapters/foreignResources.ts +0 -4
  496. package/src/adapters/import-compiler/graph.ts +7 -2
  497. package/src/adapters/imports/graph.ts +43 -18
  498. package/src/adapters/knip/configuration.ts +11 -5
  499. package/src/adapters/knip/run.ts +4 -1
  500. package/src/adapters/outsideImportFindings.ts +22 -65
  501. package/src/adapters/rule.ts +29 -6
  502. package/src/adapters/runMain.ts +7 -6
  503. package/src/adapters/{serviceModelFindings.ts → serviceModelCheck.ts} +10 -25
  504. package/src/adapters/sharedErrorCatalog.ts +43 -0
  505. package/src/adapters/sharedErrorModules.ts +1 -1
  506. package/src/adapters/specReaderSources.ts +6 -3
  507. package/src/adapters/storyProgram.ts +20 -3
  508. package/src/adapters/typeScriptProgram.ts +57 -0
  509. package/src/baseline/compare.ts +59 -19
  510. package/src/baseline/format.ts +7 -2
  511. package/src/baseline/merge.ts +15 -1
  512. package/src/baseline/rewrite.ts +3 -1
  513. package/src/baseline/update.ts +38 -8
  514. package/src/biome/exceptionConfig.ts +24 -3
  515. package/src/biome/scannerRules.ts +42 -0
  516. package/src/cli/args.ts +13 -2
  517. package/src/cli/baseline.ts +7 -1
  518. package/src/cli/lint.ts +34 -18
  519. package/src/cli/migrateExceptions.ts +8 -9
  520. package/src/cli/misplaced.ts +4 -2
  521. package/src/cli/program.ts +1 -1
  522. package/src/cli/runSet.ts +17 -0
  523. package/src/cli/shrink.ts +4 -11
  524. package/src/cli/usage.ts +7 -2
  525. package/src/config/decode.ts +1 -0
  526. package/src/config/load.ts +3 -0
  527. package/src/config/resolve.ts +11 -6
  528. package/src/config.ts +3 -0
  529. package/src/engine/childStarted.ts +8 -0
  530. package/src/engine/evaluate.ts +3 -1
  531. package/src/engine/runRule.ts +103 -0
  532. package/src/engine/runRules.ts +64 -86
  533. package/src/engine/session.ts +23 -5
  534. package/src/engine/violation.ts +16 -0
  535. package/src/exceptions/MigrationFailure.ts +5 -0
  536. package/src/exceptions/biomeFindings.ts +24 -21
  537. package/src/exceptions/migrateBiome.ts +10 -4
  538. package/src/exceptions/migrateConfig.ts +66 -29
  539. package/src/exceptions/registry.ts +2 -2
  540. package/src/hooks/preCommit.ts +22 -7
  541. package/src/hooks/stagedCheck.ts +54 -0
  542. package/src/hooks/withStagedContent.ts +111 -0
  543. package/src/imports/browserNames.ts +7 -5
  544. package/src/imports/fences/check.ts +1 -1
  545. package/src/imports/fences/compilePolicy.ts +6 -4
  546. package/src/imports/fences/evaluate.ts +2 -2
  547. package/src/imports/globMatcher.ts +42 -35
  548. package/src/imports/graph.ts +47 -3
  549. package/src/imports/pnpmWorkspacePatterns.ts +44 -39
  550. package/src/imports/withoutGenerated.ts +1 -1
  551. package/src/imports/workspace.ts +1 -1
  552. package/src/inventory/trackedPaths.ts +10 -3
  553. package/src/manifests/deliveredDependencies.ts +11 -0
  554. package/src/report/recap.ts +29 -0
  555. package/src/report/render.ts +13 -4
  556. package/src/report/runSetLine.ts +14 -0
  557. package/src/report/staleSections.ts +14 -0
  558. package/src/rule.ts +38 -7
  559. package/src/rules/biome.ts +53 -7
  560. package/src/rules/builtIn.ts +0 -2
  561. package/src/rules/effect/adapterImports.ts +1 -1
  562. package/src/rules/effect/boundary.ts +82 -83
  563. package/src/rules/effect/boundaryFindings.ts +71 -0
  564. package/src/rules/effect/boundaryReference.ts +7 -3
  565. package/src/rules/effect/contextCapture.ts +3 -2
  566. package/src/rules/effect/errorTags.ts +72 -0
  567. package/src/rules/effect/failureHonesty.ts +9 -5
  568. package/src/rules/effect/policy.ts +0 -2
  569. package/src/rules/effect/promiseBridge.ts +65 -0
  570. package/src/rules/effect/rpcBoundary.ts +111 -4
  571. package/src/rules/effect/serviceModel.ts +3 -2
  572. package/src/rules/effect/serviceParameterCheck.ts +22 -0
  573. package/src/rules/effect/serviceParameters.ts +5 -37
  574. package/src/rules/effect/sharedErrorClasses.ts +41 -3
  575. package/src/rules/effect/workspaceProgram.ts +34 -0
  576. package/src/rules/imports/runtime.ts +43 -6
  577. package/src/rules/manifestsApplication.ts +4 -5
  578. package/src/rules/manifestsNoTestKits.ts +1 -1
  579. package/src/rules/packageFindings.ts +103 -0
  580. package/src/rules/parse.ts +54 -3
  581. package/src/rules/rootedFindings.ts +19 -0
  582. package/src/rules/stories/adapterOnlyFakes.ts +1 -0
  583. package/src/rules/stories/databaseUrl.ts +1 -0
  584. package/src/rules/stories/domainOutcomes.ts +1 -0
  585. package/src/rules/stories/engine.ts +1 -0
  586. package/src/rules/stories/globalRetries.ts +1 -0
  587. package/src/rules/stories/groupedOutcomes.ts +1 -0
  588. package/src/rules/stories/importedChangeKeys.ts +2 -2
  589. package/src/rules/stories/namedValues.ts +1 -0
  590. package/src/rules/stories/noLimitImports.ts +1 -0
  591. package/src/rules/stories/positiveRefusals.ts +1 -0
  592. package/src/rules/stories/queueReadouts.ts +1 -0
  593. package/src/rules/stories/specHelpers.ts +8 -5
  594. package/src/rules/stories/specs.ts +1 -0
  595. package/src/rules/stories/waitOnEvents.ts +6 -3
  596. package/src/rules/suppressions/noDoubleCast.ts +5 -55
  597. package/src/rules/suppressions/typedCastCheck.ts +55 -0
  598. package/src/rules/unusedCode.ts +1 -0
  599. package/src/testing/adapters/cli.ts +13 -9
  600. package/src/testing/adapters/git.ts +6 -11
  601. package/src/testing/adapters/hookRepository.ts +12 -7
  602. package/src/testing/adapters/imports.ts +4 -1
  603. package/src/testing/ruleStory.ts +2 -2
  604. package/dist/adapters/biome/presetConfig.d.ts +0 -21
  605. package/dist/adapters/biome/presetConfig.d.ts.map +0 -1
  606. package/dist/adapters/biome/presetConfig.js +0 -32
  607. package/dist/adapters/biome/presetConfig.js.map +0 -1
  608. package/dist/adapters/changeKeyFindings.d.ts +0 -4
  609. package/dist/adapters/changeKeyFindings.d.ts.map +0 -1
  610. package/dist/adapters/changeKeyFindings.js.map +0 -1
  611. package/dist/adapters/contextCaptureFindings.d.ts +0 -4
  612. package/dist/adapters/contextCaptureFindings.d.ts.map +0 -1
  613. package/dist/adapters/contextCaptureFindings.js +0 -51
  614. package/dist/adapters/contextCaptureFindings.js.map +0 -1
  615. package/dist/adapters/nativeTransactionFindings.d.ts +0 -4
  616. package/dist/adapters/nativeTransactionFindings.d.ts.map +0 -1
  617. package/dist/adapters/nativeTransactionFindings.js +0 -98
  618. package/dist/adapters/nativeTransactionFindings.js.map +0 -1
  619. package/dist/adapters/rpcBoundaryFindings.d.ts +0 -4
  620. package/dist/adapters/rpcBoundaryFindings.d.ts.map +0 -1
  621. package/dist/adapters/rpcBoundaryFindings.js +0 -90
  622. package/dist/adapters/rpcBoundaryFindings.js.map +0 -1
  623. package/dist/adapters/serviceModelFindings.d.ts +0 -4
  624. package/dist/adapters/serviceModelFindings.d.ts.map +0 -1
  625. package/dist/adapters/serviceModelFindings.js.map +0 -1
  626. package/dist/adapters/sharedErrorFindings.d.ts +0 -4
  627. package/dist/adapters/sharedErrorFindings.d.ts.map +0 -1
  628. package/dist/adapters/sharedErrorFindings.js +0 -71
  629. package/dist/adapters/sharedErrorFindings.js.map +0 -1
  630. package/dist/adapters/transactionChanges.d.ts +0 -3
  631. package/dist/adapters/transactionChanges.d.ts.map +0 -1
  632. package/dist/adapters/transactionChanges.js +0 -81
  633. package/dist/adapters/transactionChanges.js.map +0 -1
  634. package/dist/adapters/vitePort.d.ts +0 -2
  635. package/dist/adapters/vitePort.d.ts.map +0 -1
  636. package/dist/adapters/vitePort.js +0 -5
  637. package/dist/adapters/vitePort.js.map +0 -1
  638. package/dist/appTestConfig.d.ts +0 -4
  639. package/dist/appTestConfig.d.ts.map +0 -1
  640. package/dist/appTestConfig.js +0 -9
  641. package/dist/appTestConfig.js.map +0 -1
  642. package/dist/appViteConfig.d.ts +0 -23
  643. package/dist/appViteConfig.d.ts.map +0 -1
  644. package/dist/appViteConfig.js +0 -17
  645. package/dist/appViteConfig.js.map +0 -1
  646. package/dist/biome/recommendedRules.d.ts +0 -3
  647. package/dist/biome/recommendedRules.d.ts.map +0 -1
  648. package/dist/biome/recommendedRules.js +0 -20
  649. package/dist/biome/recommendedRules.js.map +0 -1
  650. package/dist/rules/effect/program.d.ts +0 -8
  651. package/dist/rules/effect/program.d.ts.map +0 -1
  652. package/dist/rules/effect/program.js +0 -53
  653. package/dist/rules/effect/program.js.map +0 -1
  654. package/dist/rules/effect/sqlTransact.d.ts +0 -2
  655. package/dist/rules/effect/sqlTransact.d.ts.map +0 -1
  656. package/dist/rules/effect/sqlTransact.js +0 -9
  657. package/dist/rules/effect/sqlTransact.js.map +0 -1
  658. package/dist/rules/suppressions/biomeRecommended.d.ts +0 -7
  659. package/dist/rules/suppressions/biomeRecommended.d.ts.map +0 -1
  660. package/dist/rules/suppressions/biomeRecommended.js +0 -47
  661. package/dist/rules/suppressions/biomeRecommended.js.map +0 -1
  662. package/src/adapters/biome/presetConfig.ts +0 -34
  663. package/src/adapters/contextCaptureFindings.ts +0 -60
  664. package/src/adapters/nativeTransactionFindings.ts +0 -108
  665. package/src/adapters/rpcBoundaryFindings.ts +0 -98
  666. package/src/adapters/sharedErrorFindings.ts +0 -84
  667. package/src/adapters/transactionChanges.ts +0 -85
  668. package/src/adapters/vitePort.ts +0 -5
  669. package/src/appTestConfig.ts +0 -10
  670. package/src/appViteConfig.ts +0 -24
  671. package/src/biome/recommendedRules.ts +0 -27
  672. package/src/rules/effect/program.ts +0 -57
  673. package/src/rules/effect/sqlTransact.ts +0 -10
  674. package/src/rules/suppressions/biomeRecommended.ts +0 -60
@@ -0,0 +1,72 @@
1
+ import ts from "typescript";
2
+ import { type ImportBinding, importBindings } from "#rules/stories/importBindings.ts";
3
+ import { memberName, nodesWhere, unwrapped } from "#rules/stories/syntax.ts";
4
+
5
+ export interface TaggedClass {
6
+ readonly name: string | undefined;
7
+ readonly node: ts.ClassLikeDeclaration;
8
+ readonly tag: string;
9
+ }
10
+
11
+ export type ImportedTag = (binding: ImportBinding, member: string | undefined) => string | undefined;
12
+
13
+ const CONSTRUCTORS: ReadonlySet<string> = new Set(["TaggedError", "TaggedErrorClass"]);
14
+
15
+ function constructorTag(heritage: ts.Expression): string | undefined {
16
+ const call = unwrapped(heritage);
17
+ if (!ts.isCallExpression(call)) {
18
+ return undefined;
19
+ }
20
+ const inner = ts.isCallExpression(call.expression) ? call.expression.expression : call.expression;
21
+ const name = ts.isIdentifier(inner) ? inner.text : memberName(inner);
22
+ const [first] = call.arguments;
23
+ return CONSTRUCTORS.has(name ?? "") && first !== undefined && ts.isStringLiteralLike(first) ? first.text : undefined;
24
+ }
25
+
26
+ function propertyTag(node: ts.ClassLikeDeclaration): string | undefined {
27
+ for (const member of node.members) {
28
+ if (!(ts.isPropertyDeclaration(member) && ts.isIdentifier(member.name) && member.name.text === "_tag")) {
29
+ continue;
30
+ }
31
+ const readonly = member.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.ReadonlyKeyword) === true;
32
+ const literal = member.type !== undefined && ts.isLiteralTypeNode(member.type) ? member.type.literal : member.initializer;
33
+ return readonly && literal !== undefined && ts.isStringLiteralLike(literal) ? literal.text : undefined;
34
+ }
35
+ return undefined;
36
+ }
37
+
38
+ function extended(node: ts.ClassLikeDeclaration): ts.Expression | undefined {
39
+ return node.heritageClauses?.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword)?.types[0]?.expression;
40
+ }
41
+
42
+ function importedBase(base: ts.Expression, bindings: ReadonlyMap<string, ImportBinding>, imported: ImportedTag): string | undefined {
43
+ const namespace = ts.isPropertyAccessExpression(base) && ts.isIdentifier(base.expression) ? base.expression : undefined;
44
+ const root = namespace ?? base;
45
+ const binding = ts.isIdentifier(root) ? bindings.get(root.text) : undefined;
46
+ return binding === undefined ? undefined : imported(binding, namespace === undefined ? undefined : memberName(base));
47
+ }
48
+
49
+ // A tagged error is a class built by a TaggedError constructor with a literal tag, an Error subclass with a readonly literal _tag, or a subclass of either.
50
+ export function taggedClasses(source: ts.SourceFile, imported: ImportedTag): readonly TaggedClass[] {
51
+ const bindings = importBindings(source);
52
+ const classes = nodesWhere(source, ts.isClassLike).filter(ts.isClassLike);
53
+ const named = new Map(classes.flatMap((node) => (node.name === undefined ? [] : [[node.name.text, node] as const])));
54
+ function tagOf(node: ts.ClassLikeDeclaration, seen: ReadonlySet<ts.Node>): string | undefined {
55
+ const heritage = extended(node);
56
+ if (heritage === undefined || seen.has(node)) {
57
+ return undefined;
58
+ }
59
+ const base = unwrapped(heritage);
60
+ const local = ts.isIdentifier(base) && !bindings.has(base.text) ? named.get(base.text) : undefined;
61
+ return (
62
+ constructorTag(heritage)
63
+ ?? propertyTag(node)
64
+ ?? importedBase(base, bindings, imported)
65
+ ?? (local === undefined ? undefined : tagOf(local, new Set([...seen, node])))
66
+ );
67
+ }
68
+ return classes.flatMap((node) => {
69
+ const tag = tagOf(node, new Set());
70
+ return tag === undefined ? [] : [{ name: node.name?.text, node, tag }];
71
+ });
72
+ }
@@ -1,11 +1,12 @@
1
1
  import { join } from "node:path";
2
+ import { Effect } from "effect";
2
3
  import ts from "typescript";
3
4
  import { defineRule, type Finding, type RuleInputs } from "#rule.ts";
4
5
  import { failureFindings } from "#rules/effect/failureFindings.ts";
5
- import { effectProgram } from "#rules/effect/program.ts";
6
+ import { workspaceProgram } from "#rules/effect/workspaceProgram.ts";
6
7
 
7
- function checkFailures(inputs: RuleInputs): readonly Finding[] {
8
- const program = effectProgram(inputs, false);
8
+ const checkFailures = Effect.fn("FailureHonesty.checkFailures")(function* (inputs: RuleInputs) {
9
+ const program = yield* workspaceProgram(inputs);
9
10
  const checker = program.getTypeChecker();
10
11
  return inputs.sources.flatMap((file) => {
11
12
  const source = program.getSourceFile(join(inputs.root, file.path));
@@ -32,7 +33,7 @@ function checkFailures(inputs: RuleInputs): readonly Finding[] {
32
33
  }
33
34
  return findings;
34
35
  });
35
- }
36
+ });
36
37
 
37
38
  export const failureHonesty = defineRule({
38
39
  check: (inputs) => {
@@ -51,7 +52,10 @@ export const failureHonesty = defineRule({
51
52
  sources.push(source);
52
53
  groups.set(group, sources);
53
54
  }
54
- return [...groups.values()].flatMap((sources) => checkFailures({ ...inputs, sources }));
55
+ return Effect.map(
56
+ Effect.forEach(groups.values(), (sources) => checkFailures({ ...inputs, sources })),
57
+ (found) => found.flat(),
58
+ );
55
59
  },
56
60
  description:
57
61
  "Keep failures typed and observable: no forked forever/orDie loops, retry({ while }) without times or a pacing Schedule, blanket catch-to-success, or FileSystem option/orElseSucceed. Catch a named reason, use a Schedule that paces retries or model an explicit unavailable state. In test-support/, a blanket catch whose handler derives its value from the caught error is a readout translation and is accepted. No config exceptions or inline suppressions; baseline existing debt.",
@@ -9,7 +9,6 @@ import { serviceIds } from "#rules/effect/serviceIds.ts";
9
9
  import { serviceModel } from "#rules/effect/serviceModel.ts";
10
10
  import { serviceParameters } from "#rules/effect/serviceParameters.ts";
11
11
  import { sharedErrorClasses } from "#rules/effect/sharedErrorClasses.ts";
12
- import { sqlTransact } from "#rules/effect/sqlTransact.ts";
13
12
 
14
13
  export const effectPolicy = [
15
14
  adapterImports,
@@ -23,5 +22,4 @@ export const effectPolicy = [
23
22
  serviceModel,
24
23
  serviceParameters,
25
24
  sharedErrorClasses,
26
- sqlTransact,
27
25
  ] as const;
@@ -0,0 +1,65 @@
1
+ import ts from "typescript";
2
+ import { serviceProperty } from "#adapters/serviceAssemblySyntax.ts";
3
+ import { packageNameOf } from "#imports/packageName.ts";
4
+ import { boundaryReference } from "#rules/effect/boundaryReference.ts";
5
+
6
+ function rootIdentifier(expression: ts.Expression): ts.Identifier | undefined {
7
+ if (ts.isIdentifier(expression)) {
8
+ return expression;
9
+ }
10
+ return ts.isPropertyAccessExpression(expression) || ts.isElementAccessExpression(expression) || ts.isCallExpression(expression)
11
+ ? rootIdentifier(expression.expression)
12
+ : undefined;
13
+ }
14
+
15
+ function calleeOf(node: ts.Node): ts.Identifier | undefined {
16
+ if (ts.isTaggedTemplateExpression(node)) {
17
+ return rootIdentifier(node.tag);
18
+ }
19
+ return ts.isCallExpression(node) ? rootIdentifier(node.expression) : undefined;
20
+ }
21
+
22
+ function moduleOf(declaration: ts.Declaration): string | undefined {
23
+ if (!(ts.isImportSpecifier(declaration) || ts.isNamespaceImport(declaration) || ts.isImportClause(declaration))) {
24
+ return undefined;
25
+ }
26
+ const module = ts.findAncestor(declaration, ts.isImportDeclaration)?.moduleSpecifier;
27
+ return module !== undefined && ts.isStringLiteral(module) ? module.text : undefined;
28
+ }
29
+
30
+ // Library types stay out of this rule's program, so a library's Promise is recognised by the bridge that consumes it, from its import.
31
+ export function promiseBridge(checker: ts.TypeChecker, workspace: ReadonlySet<string>) {
32
+ function outsideLibrary(identifier: ts.Identifier): string | undefined {
33
+ const specifier = (checker.getSymbolAtLocation(identifier)?.declarations ?? []).map(moduleOf).find((found) => found !== undefined);
34
+ if (specifier === undefined || /^[.#/]/u.test(specifier)) {
35
+ return undefined;
36
+ }
37
+ const name = packageNameOf(specifier);
38
+ return name === "effect" || name.startsWith("@effect/") || name.startsWith("@shivaedev/") || name.startsWith("node:") || workspace.has(name)
39
+ ? undefined
40
+ : specifier;
41
+ }
42
+ function bridged(callback: ts.Node): string | undefined {
43
+ const root = ts.isExpression(callback) && !ts.isFunctionLike(callback) ? rootIdentifier(callback) : undefined;
44
+ const direct = root === undefined ? undefined : outsideLibrary(root);
45
+ if (direct !== undefined) {
46
+ return direct;
47
+ }
48
+ function visit(node: ts.Node): string | undefined {
49
+ const callee = calleeOf(node);
50
+ return (callee === undefined ? undefined : outsideLibrary(callee)) ?? ts.forEachChild(node, visit);
51
+ }
52
+ return ts.forEachChild(callback, visit);
53
+ }
54
+ return (node: ts.Node): string | undefined => {
55
+ if (
56
+ !(ts.isCallExpression(node) && /^effect(?:\.Effect|\/Effect)\.(?:tryPromise|promise)$/u.test(boundaryReference(checker, node.expression) ?? ""))
57
+ ) {
58
+ return undefined;
59
+ }
60
+ const [argument] = node.arguments;
61
+ const callback = argument !== undefined && ts.isObjectLiteralExpression(argument) ? serviceProperty(argument, "try") : argument;
62
+ const library = callback === undefined ? undefined : bridged(callback);
63
+ return library === undefined ? undefined : `Promise bridge to the library ${library}`;
64
+ };
65
+ }
@@ -1,10 +1,117 @@
1
- import { rpcBoundaryFindings } from "#adapters/rpcBoundaryFindings.ts";
2
- import { defineRule } from "#rule.ts";
1
+ import ts from "typescript";
2
+ import { isTestSupport } from "#naming/testName.ts";
3
+ import { defineRule, type Finding, type SourceFile } from "#rule.ts";
4
+ import { parse } from "#rules/parse.ts";
5
+ import { type ImportBinding, importBindings } from "#rules/stories/importBindings.ts";
6
+ import { findingAt, memberName, nodesWhere, unwrapped } from "#rules/stories/syntax.ts";
7
+
8
+ const BOUNDARIES: ReadonlyMap<string, string> = new Map([
9
+ ["@shivaedev/errors/boundary.ts", "rpcBoundary"],
10
+ ["@shivaedev/errors/rpcBoundaryHandlers.ts", "rpcBoundaryHandlers"],
11
+ ]);
12
+ const BUILDERS: ReadonlySet<string> = new Set(["toLayer", "toLayerHandler", "toHandlers", "of"]);
13
+ const EFFECT_MODULE = /^(?:effect|@effect\/[^/]+)(?:\/|$)/u;
14
+ const RPC_MODULE = /^(?:effect\/(?:unstable\/)?rpc|@effect\/rpc)(?:\/|$)/u;
15
+
16
+ function rootIdentifier(expression: ts.Expression): ts.Identifier | undefined {
17
+ const value = unwrapped(expression);
18
+ if (ts.isIdentifier(value)) {
19
+ return value;
20
+ }
21
+ return ts.isPropertyAccessExpression(value) || ts.isElementAccessExpression(value) || ts.isCallExpression(value)
22
+ ? rootIdentifier(value.expression)
23
+ : undefined;
24
+ }
25
+
26
+ function localValues(source: ts.SourceFile): ReadonlyMap<string, ts.Expression | undefined> {
27
+ const values = new Map<string, ts.Expression | undefined>();
28
+ for (const node of nodesWhere(source, (candidate) => ts.isVariableDeclaration(candidate) || ts.isClassLike(candidate))) {
29
+ if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name)) {
30
+ values.set(node.name.text, node.initializer);
31
+ } else if (ts.isClassLike(node) && node.name !== undefined) {
32
+ values.set(node.name.text, node.heritageClauses?.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword)?.types[0]?.expression);
33
+ }
34
+ }
35
+ return values;
36
+ }
37
+
38
+ type Origin = "effect" | "elsewhere" | "rpc" | "value";
39
+
40
+ interface Scope {
41
+ readonly bindings: ReadonlyMap<string, ImportBinding>;
42
+ readonly locals: ReadonlyMap<string, ts.Expression | undefined>;
43
+ }
44
+
45
+ function moduleOrigin(module: string): Origin {
46
+ if (RPC_MODULE.test(module)) {
47
+ return "rpc";
48
+ }
49
+ return EFFECT_MODULE.test(module) ? "effect" : "elsewhere";
50
+ }
51
+
52
+ function origin(root: ts.Identifier | undefined, scope: Scope, hops: number): Origin {
53
+ const binding = root === undefined ? undefined : scope.bindings.get(root.text);
54
+ if (binding !== undefined) {
55
+ return moduleOrigin(binding.module);
56
+ }
57
+ if (root !== undefined && !scope.locals.has(root.text)) {
58
+ return "elsewhere";
59
+ }
60
+ const value = root === undefined ? undefined : scope.locals.get(root.text);
61
+ return value === undefined || hops > 8 ? "value" : origin(rootIdentifier(value), scope, hops + 1);
62
+ }
63
+
64
+ // A group often arrives as an import or a parameter, so any such receiver builds handlers, except that a service tag's of shares the name and only a visible group or a member chain such as a contract's application counts for it.
65
+ function buildsHandlers(source: ts.SourceFile, bindings: ReadonlyMap<string, ImportBinding>): boolean {
66
+ const scope: Scope = { bindings, locals: localValues(source) };
67
+ return nodesWhere(source, ts.isCallExpression).some((call) => {
68
+ const callee = ts.isCallExpression(call) ? unwrapped(call.expression) : undefined;
69
+ if (callee === undefined || !ts.isPropertyAccessExpression(callee) || !BUILDERS.has(callee.name.text)) {
70
+ return false;
71
+ }
72
+ const from = origin(rootIdentifier(callee.expression), scope, 0);
73
+ const chained = !ts.isIdentifier(unwrapped(callee.expression));
74
+ return from === "rpc" || (from === "elsewhere" && (callee.name.text !== "of" || chained));
75
+ });
76
+ }
77
+
78
+ function boundaryCalled(call: ts.CallExpression, bindings: ReadonlyMap<string, ImportBinding>): string | undefined {
79
+ const callee = unwrapped(call.expression);
80
+ if (ts.isIdentifier(callee)) {
81
+ const binding = bindings.get(callee.text);
82
+ return binding !== undefined && BOUNDARIES.get(binding.module) === binding.imported ? binding.imported : undefined;
83
+ }
84
+ const namespace = ts.isPropertyAccessExpression(callee) && ts.isIdentifier(callee.expression) ? bindings.get(callee.expression.text) : undefined;
85
+ return namespace?.imported === "*" && BOUNDARIES.get(namespace.module) === memberName(callee) ? memberName(callee) : undefined;
86
+ }
87
+
88
+ function findings(file: SourceFile): readonly Finding[] {
89
+ const source = isTestSupport(file.path) || !file.text.includes("rpcBoundary") ? undefined : parse(file);
90
+ if (source === undefined) {
91
+ return [];
92
+ }
93
+ const bindings = importBindings(source);
94
+ if (![...bindings.values()].some((binding) => BOUNDARIES.has(binding.module)) || buildsHandlers(source, bindings)) {
95
+ return [];
96
+ }
97
+ return nodesWhere(source, ts.isCallExpression).flatMap((call) => {
98
+ const name = ts.isCallExpression(call) ? boundaryCalled(call, bindings) : undefined;
99
+ return name === undefined
100
+ ? []
101
+ : [
102
+ findingAt(
103
+ source,
104
+ call,
105
+ `Uses ${name} outside a module that builds RPC handlers. Move the boundary into the module calling the RPC group's toLayer, toLayerHandler, toHandlers or of; services must keep their own typed failures.`,
106
+ ),
107
+ ];
108
+ });
109
+ }
3
110
 
4
111
  export const rpcBoundary = defineRule({
5
- check: rpcBoundaryFindings,
112
+ check: ({ sources }) => sources.flatMap(findings),
6
113
  description:
7
- "Apply rpcBoundary and rpcBoundaryHandlers only in modules building native RPC handlers; services keep their typed failures. Test-support kits and the handler boundary implementation are accepted. No config exceptions or inline suppressions; baseline existing debt.",
114
+ "Apply rpcBoundary and rpcBoundaryHandlers, imported from @shivaedev/errors, only in modules building native RPC handlers; services keep their typed failures. Test-support kits are accepted. No config exceptions or inline suppressions; baseline existing debt.",
8
115
  id: "effect/rpc-boundary",
9
116
  registrable: false,
10
117
  });
@@ -1,8 +1,9 @@
1
- import { serviceModelFindings } from "#adapters/serviceModelFindings.ts";
1
+ import { serviceModelCheck } from "#adapters/serviceModelCheck.ts";
2
2
  import { defineRule } from "#rule.ts";
3
+ import { rootedFindings } from "#rules/rootedFindings.ts";
3
4
 
4
5
  export const serviceModel = defineRule({
5
- check: serviceModelFindings,
6
+ check: (inputs) => rootedFindings(inputs, serviceModelCheck),
6
7
  description:
7
8
  "defineService initializer state owns lifetime state, never dependencies. Every inventoried operation, including factory returns and piped bodies, is a sibling Effect.fn export with its Service.operation span. Dependencies and the caller come from the environment; the Layer registration chooses lifetime.",
8
9
  id: "effect/service-model",
@@ -0,0 +1,22 @@
1
+ import { Effect } from "effect";
2
+ import { readPackageManifest } from "#adapters/manifestInventory.ts";
3
+ import { workspacePackages } from "#imports/workspace.ts";
4
+ import type { RuleInputs, SourceFile, TypeScriptProgram } from "#rule.ts";
5
+ import { serviceCatalog } from "#rules/effect/serviceCatalog.ts";
6
+ import { serviceFindings } from "#rules/effect/serviceFindings.ts";
7
+
8
+ export const serviceParameterCheck = Effect.fn("Services.serviceParameterCheck")(function* (inputs: RuleInputs) {
9
+ const packages = yield* workspacePackages(inputs);
10
+ const root = yield* readPackageManifest(inputs.readText, "package.json");
11
+ const names = [...packages.map((owner) => owner.name), ...(root?.name === undefined ? [] : [root.name])];
12
+ return {
13
+ checks: (file: SourceFile) => !/(?:^|\/)test-support\//u.test(file.path),
14
+ findings: (files: readonly SourceFile[], { checker, program, sourceFile }: TypeScriptProgram) =>
15
+ serviceFindings(
16
+ inputs.root,
17
+ files.flatMap((file) => sourceFile(file.path) ?? []),
18
+ checker,
19
+ serviceCatalog(program, checker, names),
20
+ ),
21
+ };
22
+ });
@@ -1,43 +1,11 @@
1
- import { join } from "node:path";
2
- import { Effect } from "effect";
3
- import { readPackageManifest } from "#adapters/manifestInventory.ts";
4
- import { packageOf, workspacePackages } from "#imports/workspace.ts";
5
- import { defineRule, type Finding, type RuleInputs } from "#rule.ts";
6
- import { effectPrograms } from "#rules/effect/program.ts";
7
- import { serviceCatalog } from "#rules/effect/serviceCatalog.ts";
8
- import { serviceFindings } from "#rules/effect/serviceFindings.ts";
1
+ import { defineRule } from "#rule.ts";
2
+ import { packageFindings } from "#rules/packageFindings.ts";
9
3
 
10
4
  export const serviceParameters = defineRule({
11
- check: Effect.fn("Services.check")(function* (inputs: RuleInputs) {
12
- const packages = yield* workspacePackages(inputs);
13
- const root = yield* readPackageManifest(inputs.readText, "package.json");
14
- const names = [...packages.map((owner) => owner.name), ...(root?.name === undefined ? [] : [root.name])];
15
- const groups = new Map<string, RuleInputs["sources"][number][]>();
16
- for (const source of inputs.sources) {
17
- if (/(?:^|\/)test-support\//u.test(source.path)) {
18
- continue;
19
- }
20
- const group = packageOf(packages, source.path)?.directory ?? ".";
21
- const files = groups.get(group) ?? [];
22
- files.push(source);
23
- groups.set(group, files);
24
- }
25
- const programs = effectPrograms(inputs);
26
- const findings: Finding[] = [];
27
- for (const files of groups.values()) {
28
- const program = programs.create(files);
29
- const checker = program.getTypeChecker();
30
- const sources = files.flatMap((file) => {
31
- const source = program.getSourceFile(join(inputs.root, file.path));
32
- return source === undefined ? [] : [source];
33
- });
34
- findings.push(...serviceFindings(inputs.root, sources, checker, serviceCatalog(program, checker, names)));
35
- programs.release();
36
- }
37
- return findings;
38
- }),
5
+ check: (inputs) => packageFindings(inputs, "effect/service-parameters"),
6
+ depth: "deep",
39
7
  description:
40
- "Exported and local functions and public methods take services from Effect's environment, including aliases, constraints, inferred/destructured parameters and factory returns. Service keys/classes, non-empty Contexts and implementation shapes are services; Effect/Stream requirements are computations. Service implementation methods, framework callbacks, module-level React components and their props, owned initializer state, foreign host callbacks in object literals and classes, owned foreign adapter resources, Layer constructors, registries and RPC clients held by plain functions outside Effect bodies, and tags only handed to middleware declarations or Context.pick are accepted. Within Effect code, test-support/ folders are exempt. The fixed adapters/ convention bridges outside libraries to Effect values; adapters still follow this rule and ambient runtime bans. No config exceptions or inline suppressions; baseline existing debt.",
8
+ "Exported and local functions and public methods take services from Effect's environment, including aliases, constraints, inferred/destructured parameters and factory returns. Service keys/classes, non-empty Contexts and implementation shapes are services; Effect/Stream requirements are computations. Service implementation methods, framework callbacks, module-level React components and their props, owned initializer state, foreign host callbacks in object literals and classes, owned foreign resources, Layer constructors, registries and RPC clients held by plain functions outside Effect bodies, and tags only handed to middleware declarations or Context.pick are accepted. Within Effect code, test-support/ folders are exempt. adapters/ folders still follow this rule and the ambient runtime bans. No config exceptions or inline suppressions; baseline existing debt.",
41
9
  id: "effect/service-parameters",
42
10
  registrable: false,
43
11
  });
@@ -1,8 +1,46 @@
1
- import { sharedErrorFindings } from "#adapters/sharedErrorFindings.ts";
2
- import { defineRule } from "#rule.ts";
1
+ import { Effect } from "effect";
2
+ import { type SharedErrorCatalog, sharedErrorCatalog } from "#adapters/sharedErrorCatalog.ts";
3
+ import { defineRule, type Finding, type SourceFile } from "#rule.ts";
4
+ import { taggedClasses } from "#rules/effect/errorTags.ts";
5
+ import { parse } from "#rules/parse.ts";
6
+ import { findingAt } from "#rules/stories/syntax.ts";
7
+
8
+ function declaresErrors(source: SourceFile): boolean {
9
+ return /\bclass\b/u.test(source.text) && /TaggedError|_tag|@shivaedev\/errors/u.test(source.text);
10
+ }
11
+
12
+ function findings(file: SourceFile, catalog: SharedErrorCatalog): readonly Finding[] {
13
+ const source = parse(file);
14
+ if (source === undefined) {
15
+ return [];
16
+ }
17
+ const classes = taggedClasses(source, (binding, member) =>
18
+ catalog.tagOf(binding.module, binding.imported === "*" ? (member ?? "") : binding.imported),
19
+ );
20
+ return classes.flatMap(({ name, node, tag }) => {
21
+ const shared = catalog.byTag.get(tag);
22
+ return shared === undefined || (shared.path === file.path && shared.name === name)
23
+ ? []
24
+ : [
25
+ findingAt(
26
+ source,
27
+ node,
28
+ `Tagged error ${name ?? "anonymous class"} reuses the shared tag "${tag}". Import ${shared.name} from "${shared.specifier}" and use that class instead.`,
29
+ ),
30
+ ];
31
+ });
32
+ }
3
33
 
4
34
  export const sharedErrorClasses = defineRule({
5
- check: sharedErrorFindings,
35
+ check: (inputs) =>
36
+ Effect.gen(function* () {
37
+ const sources = inputs.sources.filter(declaresErrors);
38
+ if (sources.length === 0) {
39
+ return [];
40
+ }
41
+ const catalog = yield* sharedErrorCatalog({ ...inputs, sources });
42
+ return catalog.byTag.size === 0 ? [] : sources.flatMap((file) => findings(file, catalog));
43
+ }),
6
44
  description:
7
45
  "A tagged error with a tag exported by @shivaedev/errors must use that exported class. Import the shared class instead of declaring another error or subclass with its tag.",
8
46
  id: "effect/shared-error-classes",
@@ -0,0 +1,34 @@
1
+ import { join } from "node:path";
2
+ import { Effect } from "effect";
3
+ import ts from "typescript";
4
+ import { DeclarationFiles } from "#adapters/declaration-files/service.ts";
5
+ import { projectsFor } from "#adapters/imports/projects.ts";
6
+ import type { RuleInputs } from "#rule.ts";
7
+
8
+ // Imports of installed packages stay unresolved: these rules judge the repository's own code and treat outside libraries as untyped.
9
+ export const workspaceProgram = Effect.fn("WorkspaceProgram.workspaceProgram")(function* (inputs: RuleInputs) {
10
+ const projectOf = projectsFor(inputs.root);
11
+ const options: ts.CompilerOptions = {
12
+ allowJs: true,
13
+ jsx: ts.JsxEmit.Preserve,
14
+ skipLibCheck: true,
15
+ strict: true,
16
+ target: ts.ScriptTarget.ESNext,
17
+ types: [],
18
+ };
19
+ const host = ts.createCompilerHost(options);
20
+ const texts = new Map(inputs.sources.map((source) => [join(inputs.root, source.path), source.text]));
21
+ const read = host.readFile;
22
+ host.readFile = (path) => texts.get(path) ?? read(path);
23
+ host.resolveModuleNames = (names, from) =>
24
+ names.map((name) => {
25
+ if (!(name.startsWith(".") || name.startsWith("#") || name.startsWith("@shivaedev/"))) {
26
+ return undefined;
27
+ }
28
+ const project = projectOf(from);
29
+ return ts.resolveModuleName(name, from, project.typesOptions, host, project.typesCache).resolvedModule;
30
+ });
31
+ const declarations = yield* DeclarationFiles;
32
+ host.getSourceFile = yield* declarations.reader(host, options);
33
+ return ts.createProgram([...texts.keys()], options, host);
34
+ });
@@ -1,6 +1,8 @@
1
1
  import { Effect } from "effect";
2
2
  import { builtinName } from "#adapters/builtinName.ts";
3
- import { type ImportGraph, importGraph } from "#imports/graph.ts";
3
+ import type { Endpoint } from "#imports/Endpoint.ts";
4
+ import { outgoing, walkFrom } from "#imports/fences/reach.ts";
5
+ import { type ImportEdge, type ImportGraph, importGraph } from "#imports/graph.ts";
4
6
  import { nodePlatformBarrels } from "#imports/nodePlatformBarrels.ts";
5
7
  import { type Runtime, runtimeDeclarationProblems, runtimeOf } from "#imports/runtime.ts";
6
8
  import { isTestCode } from "#naming/testName.ts";
@@ -13,22 +15,57 @@ function forbiddenImport(from: Runtime, to: Runtime | undefined, builtin: boolea
13
15
  return from === "client" && (to === "server" || builtin);
14
16
  }
15
17
 
18
+ const REPAIR = "Move runtime-dependent code into src/client/ or src/server/ and keep shared code independent of both runtimes.";
19
+
20
+ function forbiddenTarget(from: Runtime, runtime: (path: string) => Runtime | undefined) {
21
+ return (endpoint: Endpoint): string | undefined => {
22
+ const to = endpoint.kind === "file" ? runtime(endpoint.path) : undefined;
23
+ const builtin = endpoint.kind === "external" && builtinName(endpoint.specifier) !== undefined;
24
+ if (!forbiddenImport(from, to, builtin)) {
25
+ return undefined;
26
+ }
27
+ return builtin ? "Node built-in" : `${to} code`;
28
+ };
29
+ }
30
+
31
+ function importer(from: Runtime): string {
32
+ return from === "client" ? "Client" : "Shared";
33
+ }
34
+
35
+ interface IgnoredReach {
36
+ readonly edgesFrom: ReadonlyMap<string, readonly ImportEdge[]>;
37
+ readonly modules: ReadonlySet<string>;
38
+ }
39
+
40
+ // An ignored module, such as generated output, is never reported itself, so its forbidden imports land on the checked file that reaches them.
41
+ function ignoredFindings(ignored: IgnoredReach, edge: ImportEdge, from: Runtime, runtime: (path: string) => Runtime | undefined) {
42
+ if (edge.to.kind !== "file" || !ignored.modules.has(edge.to.path)) {
43
+ return [];
44
+ }
45
+ return walkFrom(edge.to.path, ignored.edgesFrom, forbiddenTarget(from, runtime)).reached.map((reached) => ({
46
+ file: edge.from,
47
+ line: edge.line,
48
+ message: `${importer(from)} code reaches ${reached.match} through "${edge.specifier}", which git ignores: ${reached.path.join(" -> ")}. ${REPAIR}`,
49
+ subject: edge.specifier,
50
+ }));
51
+ }
52
+
16
53
  function runtimeFindings(graph: ImportGraph, runtime: (path: string) => Runtime | undefined) {
54
+ const ignored = { edgesFrom: outgoing(graph.ignoredEdges), modules: new Set(graph.ignoredModules) };
17
55
  return graph.edges.flatMap((edge) => {
18
56
  const from = runtime(edge.from);
19
57
  if (from === undefined || isTestCode(edge.from)) {
20
58
  return [];
21
59
  }
22
- const to = edge.to.kind === "file" ? runtime(edge.to.path) : undefined;
23
- const builtin = edge.to.kind === "external" && builtinName(edge.to.specifier) !== undefined;
24
- if (!forbiddenImport(from, to, builtin)) {
25
- return [];
60
+ const forbidden = forbiddenTarget(from, runtime)(edge.to);
61
+ if (forbidden === undefined) {
62
+ return ignoredFindings(ignored, edge, from, runtime);
26
63
  }
27
64
  return [
28
65
  {
29
66
  file: edge.from,
30
67
  line: edge.line,
31
- message: `${from === "client" ? "Client" : "Shared"} code imports ${builtin ? "Node built-in" : `${to} code`} through "${edge.specifier}". Move runtime-dependent code into src/client/ or src/server/ and keep shared code independent of both runtimes.`,
68
+ message: `${importer(from)} code imports ${forbidden} through "${edge.specifier}". ${REPAIR}`,
32
69
  subject: edge.specifier,
33
70
  },
34
71
  ];
@@ -1,5 +1,5 @@
1
1
  import { dirname, posix, relative, resolve, sep } from "node:path";
2
- import { Effect } from "effect";
2
+ import { Effect, Result } from "effect";
3
3
  import { type ManifestReadFailure, readPackageManifest } from "#adapters/manifestInventory.ts";
4
4
  import { pnpmWorkspaceList } from "#imports/pnpmWorkspacePatterns.ts";
5
5
  import { workspacePackages } from "#imports/workspace.ts";
@@ -48,10 +48,9 @@ const hoistFindings = Effect.fn("Manifests.hoistFindings")(function* (
48
48
  if (workspace === undefined) {
49
49
  return [{ file: manifestPath, message: `Depends on "${PLATFORM}" without a pnpm-workspace.yaml. ${repair}`, subject: HOIST_KEY }];
50
50
  }
51
- const parsed = yield* Effect.try({ catch: (cause) => cause, try: () => pnpmWorkspaceList(workspace.text, HOIST_KEY) }).pipe(Effect.result);
52
- if (parsed._tag === "Failure") {
53
- const cause = parsed.failure;
54
- return [{ file: workspace.path, message: `${cause instanceof Error ? cause.message : String(cause)}. Write ${HOIST_LINE}.`, subject: HOIST_KEY }];
51
+ const parsed = pnpmWorkspaceList(workspace.text, HOIST_KEY);
52
+ if (Result.isFailure(parsed)) {
53
+ return [{ file: workspace.path, message: `${parsed.failure.message}. Write ${HOIST_LINE}.`, subject: HOIST_KEY }];
55
54
  }
56
55
  const patterns = parsed.success;
57
56
  const included = patterns.some((pattern) => !pattern.startsWith("!") && hoists(pattern));
@@ -8,7 +8,7 @@ import { defineRule, type Finding, type RuleInputs } from "#rule.ts";
8
8
 
9
9
  const TEST_PACKAGES = new Set(["@shivaedev/test", "@shivaedev/test-story", "@shivaedev/test-sql", "@shivaedev/test-kits", "vitest"]);
10
10
 
11
- const TEST_TOOLING = new Set([...TEST_PACKAGES, "@shivaedev/quality", "@shivaedev/vitest-rerun"]);
11
+ const TEST_TOOLING = new Set([...TEST_PACKAGES, "@shivaedev/build", "@shivaedev/quality", "@shivaedev/vitest-rerun"]);
12
12
 
13
13
  function testingModule(path: string): boolean {
14
14
  return isTestCode(path) || /(?:^|\/)(?:testing|test-support)(?:\/|\.|$)/u.test(path);