@shivaedev/quality 0.74.3 → 0.76.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 (535) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +16 -5
  3. package/dist/adapters/asciiFindings.d.ts +1 -1
  4. package/dist/adapters/asciiFindings.d.ts.map +1 -1
  5. package/dist/adapters/asciiFindings.js +1 -1
  6. package/dist/adapters/asciiFindings.js.map +1 -1
  7. package/dist/adapters/biome/configs.d.ts +4 -1
  8. package/dist/adapters/biome/configs.d.ts.map +1 -1
  9. package/dist/adapters/biome/configs.js +32 -27
  10. package/dist/adapters/biome/configs.js.map +1 -1
  11. package/dist/adapters/biome/presetConfig.d.ts +2 -2
  12. package/dist/adapters/biome/presetConfig.d.ts.map +1 -1
  13. package/dist/adapters/biome/presetConfig.js +5 -5
  14. package/dist/adapters/biome/presetConfig.js.map +1 -1
  15. package/dist/adapters/biome/resolvePackage.d.ts +2 -2
  16. package/dist/adapters/biome/resolvePackage.d.ts.map +1 -1
  17. package/dist/adapters/biome/resolvePackage.js +5 -4
  18. package/dist/adapters/biome/resolvePackage.js.map +1 -1
  19. package/dist/adapters/biome/rootConfig.d.ts +3 -2
  20. package/dist/adapters/biome/rootConfig.d.ts.map +1 -1
  21. package/dist/adapters/biome/rootConfig.js +4 -3
  22. package/dist/adapters/biome/rootConfig.js.map +1 -1
  23. package/dist/adapters/biome/toolContractDefaults.d.ts +1 -1
  24. package/dist/adapters/biome/toolContractDefaults.d.ts.map +1 -1
  25. package/dist/adapters/biome/toolContractDefaults.js +2 -5
  26. package/dist/adapters/biome/toolContractDefaults.js.map +1 -1
  27. package/dist/adapters/builtinName.d.ts +2 -0
  28. package/dist/adapters/builtinName.d.ts.map +1 -0
  29. package/dist/adapters/builtinName.js +9 -0
  30. package/dist/adapters/builtinName.js.map +1 -0
  31. package/dist/adapters/catalogWorkspace.d.ts +1 -1
  32. package/dist/adapters/catalogWorkspace.d.ts.map +1 -1
  33. package/dist/adapters/catalogWorkspace.js +1 -1
  34. package/dist/adapters/catalogWorkspace.js.map +1 -1
  35. package/dist/adapters/commandLine.d.ts +15 -0
  36. package/dist/adapters/commandLine.d.ts.map +1 -0
  37. package/dist/adapters/commandLine.js +10 -0
  38. package/dist/adapters/commandLine.js.map +1 -0
  39. package/dist/adapters/contentHashedModule.d.ts +2 -0
  40. package/dist/adapters/contentHashedModule.d.ts.map +1 -0
  41. package/dist/adapters/contentHashedModule.js +9 -0
  42. package/dist/adapters/contentHashedModule.js.map +1 -0
  43. package/dist/adapters/databaseUrlFindings.d.ts +1 -1
  44. package/dist/adapters/databaseUrlFindings.d.ts.map +1 -1
  45. package/dist/adapters/domEnvironment.config.d.ts.map +1 -0
  46. package/dist/adapters/domEnvironment.config.js.map +1 -0
  47. package/dist/adapters/freshObject.d.ts +3 -0
  48. package/dist/adapters/freshObject.d.ts.map +1 -0
  49. package/dist/adapters/freshObject.js +53 -0
  50. package/dist/adapters/freshObject.js.map +1 -0
  51. package/dist/adapters/imports/resolve.d.ts.map +1 -1
  52. package/dist/adapters/imports/resolve.js +2 -1
  53. package/dist/adapters/imports/resolve.js.map +1 -1
  54. package/dist/adapters/knip/configuration.d.ts +3 -2
  55. package/dist/adapters/knip/configuration.d.ts.map +1 -1
  56. package/dist/adapters/knip/configuration.js +13 -8
  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/entryPointFindings.js +4 -4
  61. package/dist/adapters/knip/entryPointFindings.js.map +1 -1
  62. package/dist/adapters/knip/run.d.ts +1 -1
  63. package/dist/adapters/knip/run.d.ts.map +1 -1
  64. package/dist/adapters/knip/run.js +2 -2
  65. package/dist/adapters/knip/run.js.map +1 -1
  66. package/dist/adapters/knip/sourceConfig.d.ts +1 -1
  67. package/dist/adapters/knip/sourceConfig.d.ts.map +1 -1
  68. package/dist/adapters/knip/sourceConfig.js +1 -1
  69. package/dist/adapters/knip/sourceConfig.js.map +1 -1
  70. package/dist/adapters/manifestInventory.d.ts +45 -4
  71. package/dist/adapters/manifestInventory.d.ts.map +1 -1
  72. package/dist/adapters/manifestInventory.js +26 -32
  73. package/dist/adapters/manifestInventory.js.map +1 -1
  74. package/dist/adapters/manifestReader.d.ts +2 -2
  75. package/dist/adapters/manifestReader.d.ts.map +1 -1
  76. package/dist/adapters/manifestReader.js +3 -4
  77. package/dist/adapters/manifestReader.js.map +1 -1
  78. package/dist/adapters/manifestSorting.d.ts +8 -0
  79. package/dist/adapters/manifestSorting.d.ts.map +1 -0
  80. package/dist/adapters/manifestSorting.js +6 -0
  81. package/dist/adapters/manifestSorting.js.map +1 -0
  82. package/dist/adapters/outsideImportFindings.d.ts +4 -1
  83. package/dist/adapters/outsideImportFindings.d.ts.map +1 -1
  84. package/dist/adapters/outsideImportFindings.js +1 -1
  85. package/dist/adapters/outsideImportFindings.js.map +1 -1
  86. package/dist/adapters/queueReadoutFindings.d.ts +1 -1
  87. package/dist/adapters/queueReadoutFindings.d.ts.map +1 -1
  88. package/dist/adapters/queueReadoutFindings.js +1 -1
  89. package/dist/adapters/queueReadoutFindings.js.map +1 -1
  90. package/dist/adapters/repositoryPathFindings.d.ts +1 -1
  91. package/dist/adapters/repositoryPathFindings.d.ts.map +1 -1
  92. package/dist/adapters/repositoryPathFindings.js +1 -1
  93. package/dist/adapters/repositoryPathFindings.js.map +1 -1
  94. package/dist/adapters/rpcBoundaryFindings.d.ts +1 -1
  95. package/dist/adapters/rpcBoundaryFindings.d.ts.map +1 -1
  96. package/dist/adapters/rule.d.ts +1 -1
  97. package/dist/adapters/rule.d.ts.map +1 -1
  98. package/dist/adapters/rule.js +2 -3
  99. package/dist/adapters/rule.js.map +1 -1
  100. package/dist/adapters/runMain.d.ts.map +1 -0
  101. package/dist/adapters/runMain.js.map +1 -0
  102. package/dist/adapters/serviceIdFindings.d.ts +1 -1
  103. package/dist/adapters/serviceIdFindings.d.ts.map +1 -1
  104. package/dist/adapters/serviceIdFindings.js +1 -1
  105. package/dist/adapters/serviceIdFindings.js.map +1 -1
  106. package/dist/adapters/sharedErrorFindings.d.ts +1 -1
  107. package/dist/adapters/sharedErrorFindings.d.ts.map +1 -1
  108. package/dist/adapters/sharedErrorFindings.js +1 -1
  109. package/dist/adapters/sharedErrorFindings.js.map +1 -1
  110. package/dist/adapters/sharedErrorModules.d.ts +2 -1
  111. package/dist/adapters/sharedErrorModules.d.ts.map +1 -1
  112. package/dist/adapters/sharedErrorModules.js +4 -3
  113. package/dist/adapters/sharedErrorModules.js.map +1 -1
  114. package/dist/adapters/testProjects.js +2 -2
  115. package/dist/adapters/testProjects.js.map +1 -1
  116. package/dist/adapters/unitIoGuard.config.d.ts.map +1 -0
  117. package/dist/adapters/unitIoGuard.config.js.map +1 -0
  118. package/dist/appTestConfig.d.ts +2 -1
  119. package/dist/appTestConfig.d.ts.map +1 -1
  120. package/dist/appTestConfig.js +2 -3
  121. package/dist/appTestConfig.js.map +1 -1
  122. package/dist/baseline/format.d.ts +1 -1
  123. package/dist/baseline/format.d.ts.map +1 -1
  124. package/dist/baseline/format.js +2 -2
  125. package/dist/baseline/format.js.map +1 -1
  126. package/dist/baseline/legacy.d.ts +1 -1
  127. package/dist/baseline/legacy.d.ts.map +1 -1
  128. package/dist/baseline/legacy.js +2 -2
  129. package/dist/baseline/legacy.js.map +1 -1
  130. package/dist/baseline/looseStagedEntries.js +2 -2
  131. package/dist/baseline/looseStagedEntries.js.map +1 -1
  132. package/dist/baseline/merge.js +1 -1
  133. package/dist/baseline/merge.js.map +1 -1
  134. package/dist/biome/report.d.ts +1 -1
  135. package/dist/biome/report.d.ts.map +1 -1
  136. package/dist/biome/withoutEntryPointImports.d.ts +1 -1
  137. package/dist/biome/withoutEntryPointImports.d.ts.map +1 -1
  138. package/dist/biome/withoutEntryPointImports.js +2 -2
  139. package/dist/biome/withoutEntryPointImports.js.map +1 -1
  140. package/dist/cli/args.d.ts.map +1 -1
  141. package/dist/cli/args.js +3 -6
  142. package/dist/cli/args.js.map +1 -1
  143. package/dist/cli/lint.d.ts +8 -1
  144. package/dist/cli/lint.d.ts.map +1 -1
  145. package/dist/cli/lint.js +9 -4
  146. package/dist/cli/lint.js.map +1 -1
  147. package/dist/cli/migrateBaseline.d.ts.map +1 -1
  148. package/dist/cli/migrateBaseline.js +1 -3
  149. package/dist/cli/migrateBaseline.js.map +1 -1
  150. package/dist/cli/migrateExceptions.d.ts.map +1 -1
  151. package/dist/cli/migrateExceptions.js +7 -10
  152. package/dist/cli/migrateExceptions.js.map +1 -1
  153. package/dist/cli.js +1 -1
  154. package/dist/cli.js.map +1 -1
  155. package/dist/config/decode.d.ts +1 -1
  156. package/dist/config/decode.d.ts.map +1 -1
  157. package/dist/config/load.js +1 -1
  158. package/dist/config/load.js.map +1 -1
  159. package/dist/decoded.d.ts +1 -1
  160. package/dist/decoded.d.ts.map +1 -1
  161. package/dist/decoded.js +2 -2
  162. package/dist/decoded.js.map +1 -1
  163. package/dist/docs/importFindings.d.ts +4 -3
  164. package/dist/docs/importFindings.d.ts.map +1 -1
  165. package/dist/docs/importFindings.js.map +1 -1
  166. package/dist/docs/linkFindings.d.ts +3 -2
  167. package/dist/docs/linkFindings.d.ts.map +1 -1
  168. package/dist/docs/linkFindings.js.map +1 -1
  169. package/dist/engine/baselineFile.js +1 -1
  170. package/dist/engine/baselineFile.js.map +1 -1
  171. package/dist/engine/session.d.ts.map +1 -1
  172. package/dist/engine/session.js +1 -1
  173. package/dist/engine/session.js.map +1 -1
  174. package/dist/exceptions/MigrationFailure.d.ts +9 -0
  175. package/dist/exceptions/MigrationFailure.d.ts.map +1 -0
  176. package/dist/exceptions/MigrationFailure.js +4 -0
  177. package/dist/exceptions/MigrationFailure.js.map +1 -0
  178. package/dist/exceptions/biomeFindings.d.ts +3 -2
  179. package/dist/exceptions/biomeFindings.d.ts.map +1 -1
  180. package/dist/exceptions/biomeFindings.js +2 -2
  181. package/dist/exceptions/biomeFindings.js.map +1 -1
  182. package/dist/exceptions/declaration.d.ts +1 -1
  183. package/dist/exceptions/declaration.d.ts.map +1 -1
  184. package/dist/exceptions/migrateBiome.d.ts +3 -1
  185. package/dist/exceptions/migrateBiome.d.ts.map +1 -1
  186. package/dist/exceptions/migrateBiome.js +5 -3
  187. package/dist/exceptions/migrateBiome.js.map +1 -1
  188. package/dist/exceptions/migrateConfig.d.ts +3 -1
  189. package/dist/exceptions/migrateConfig.d.ts.map +1 -1
  190. package/dist/exceptions/migrateConfig.js +40 -25
  191. package/dist/exceptions/migrateConfig.js.map +1 -1
  192. package/dist/exceptions/registry.d.ts +1 -1
  193. package/dist/exceptions/registry.d.ts.map +1 -1
  194. package/dist/exceptions/registry.js +1 -1
  195. package/dist/exceptions/registry.js.map +1 -1
  196. package/dist/hooks/preCommit.d.ts.map +1 -1
  197. package/dist/hooks/preCommit.js +9 -8
  198. package/dist/hooks/preCommit.js.map +1 -1
  199. package/dist/imports/browserGlobals.d.ts +1 -1
  200. package/dist/imports/browserGlobals.d.ts.map +1 -1
  201. package/dist/imports/browserGlobals.js +7 -2
  202. package/dist/imports/browserGlobals.js.map +1 -1
  203. package/dist/imports/browserNames.d.ts +3 -1
  204. package/dist/imports/browserNames.d.ts.map +1 -1
  205. package/dist/imports/browserNames.js +9 -5
  206. package/dist/imports/browserNames.js.map +1 -1
  207. package/dist/imports/departures.d.ts +1 -1
  208. package/dist/imports/departures.d.ts.map +1 -1
  209. package/dist/imports/departures.js +1 -1
  210. package/dist/imports/departures.js.map +1 -1
  211. package/dist/imports/fences/BoundaryFailure.d.ts +10 -0
  212. package/dist/imports/fences/BoundaryFailure.d.ts.map +1 -0
  213. package/dist/imports/fences/BoundaryFailure.js +4 -0
  214. package/dist/imports/fences/BoundaryFailure.js.map +1 -0
  215. package/dist/imports/fences/check.d.ts +1 -1
  216. package/dist/imports/fences/check.d.ts.map +1 -1
  217. package/dist/imports/fences/check.js +2 -2
  218. package/dist/imports/fences/check.js.map +1 -1
  219. package/dist/imports/fences/compilePolicy.d.ts +3 -1
  220. package/dist/imports/fences/compilePolicy.d.ts.map +1 -1
  221. package/dist/imports/fences/compilePolicy.js +4 -2
  222. package/dist/imports/fences/compilePolicy.js.map +1 -1
  223. package/dist/imports/fences/declarations.d.ts +1 -1
  224. package/dist/imports/fences/declarations.d.ts.map +1 -1
  225. package/dist/imports/fences/discover.d.ts +3 -1
  226. package/dist/imports/fences/discover.d.ts.map +1 -1
  227. package/dist/imports/fences/discover.js +32 -26
  228. package/dist/imports/fences/discover.js.map +1 -1
  229. package/dist/imports/fences/match.d.ts.map +1 -1
  230. package/dist/imports/fences/match.js +2 -1
  231. package/dist/imports/fences/match.js.map +1 -1
  232. package/dist/imports/globMatcher.d.ts +10 -1
  233. package/dist/imports/globMatcher.d.ts.map +1 -1
  234. package/dist/imports/globMatcher.js +39 -42
  235. package/dist/imports/globMatcher.js.map +1 -1
  236. package/dist/imports/graph.d.ts +1 -1
  237. package/dist/imports/graph.d.ts.map +1 -1
  238. package/dist/imports/graph.js +1 -1
  239. package/dist/imports/graph.js.map +1 -1
  240. package/dist/imports/packageName.d.ts +0 -1
  241. package/dist/imports/packageName.d.ts.map +1 -1
  242. package/dist/imports/packageName.js +1 -8
  243. package/dist/imports/packageName.js.map +1 -1
  244. package/dist/imports/pnpmWorkspacePatterns.d.ts +12 -2
  245. package/dist/imports/pnpmWorkspacePatterns.d.ts.map +1 -1
  246. package/dist/imports/pnpmWorkspacePatterns.js +31 -32
  247. package/dist/imports/pnpmWorkspacePatterns.js.map +1 -1
  248. package/dist/imports/runtime.d.ts +2 -2
  249. package/dist/imports/runtime.d.ts.map +1 -1
  250. package/dist/imports/runtime.js +2 -2
  251. package/dist/imports/runtime.js.map +1 -1
  252. package/dist/imports/segmentsMatch.d.ts +5 -0
  253. package/dist/imports/segmentsMatch.d.ts.map +1 -0
  254. package/dist/imports/segmentsMatch.js +16 -0
  255. package/dist/imports/segmentsMatch.js.map +1 -0
  256. package/dist/imports/withoutGenerated.d.ts +1 -1
  257. package/dist/imports/withoutGenerated.d.ts.map +1 -1
  258. package/dist/imports/withoutGenerated.js +1 -1
  259. package/dist/imports/withoutGenerated.js.map +1 -1
  260. package/dist/imports/workspace.d.ts +2 -1
  261. package/dist/imports/workspace.d.ts.map +1 -1
  262. package/dist/imports/workspace.js +17 -15
  263. package/dist/imports/workspace.js.map +1 -1
  264. package/dist/inventory/programmaticBuilds.d.ts +1 -1
  265. package/dist/inventory/programmaticBuilds.d.ts.map +1 -1
  266. package/dist/manifests/deliveredDependencies.d.ts +3 -0
  267. package/dist/manifests/deliveredDependencies.d.ts.map +1 -0
  268. package/dist/manifests/deliveredDependencies.js +8 -0
  269. package/dist/manifests/deliveredDependencies.js.map +1 -0
  270. package/dist/manifests/entryPoints.d.ts +2 -1
  271. package/dist/manifests/entryPoints.d.ts.map +1 -1
  272. package/dist/manifests/entryPoints.js +9 -8
  273. package/dist/manifests/entryPoints.js.map +1 -1
  274. package/dist/manifests/sorted.d.ts +0 -7
  275. package/dist/manifests/sorted.d.ts.map +1 -1
  276. package/dist/manifests/sorted.js +3 -10
  277. package/dist/manifests/sorted.js.map +1 -1
  278. package/dist/naming/developmentCode.d.ts +1 -1
  279. package/dist/naming/developmentCode.d.ts.map +1 -1
  280. package/dist/naming/developmentCode.js +2 -2
  281. package/dist/naming/developmentCode.js.map +1 -1
  282. package/dist/naming/packageLayout.d.ts +2 -1
  283. package/dist/naming/packageLayout.d.ts.map +1 -1
  284. package/dist/naming/packageLayout.js +4 -1
  285. package/dist/naming/packageLayout.js.map +1 -1
  286. package/dist/naming/packageTests.d.ts +1 -1
  287. package/dist/naming/packageTests.d.ts.map +1 -1
  288. package/dist/naming/packageTests.js +2 -2
  289. package/dist/naming/packageTests.js.map +1 -1
  290. package/dist/naming/testCode.d.ts +1 -1
  291. package/dist/naming/testCode.d.ts.map +1 -1
  292. package/dist/naming/testCode.js +1 -1
  293. package/dist/naming/testCode.js.map +1 -1
  294. package/dist/report/recap.d.ts +4 -0
  295. package/dist/report/recap.d.ts.map +1 -0
  296. package/dist/report/recap.js +23 -0
  297. package/dist/report/recap.js.map +1 -0
  298. package/dist/report/render.d.ts +1 -0
  299. package/dist/report/render.d.ts.map +1 -1
  300. package/dist/report/render.js +1 -1
  301. package/dist/report/render.js.map +1 -1
  302. package/dist/rule.d.ts +2 -2
  303. package/dist/rule.d.ts.map +1 -1
  304. package/dist/rules/biome.js +1 -1
  305. package/dist/rules/biome.js.map +1 -1
  306. package/dist/rules/docs/references.d.ts.map +1 -1
  307. package/dist/rules/docs/references.js +6 -10
  308. package/dist/rules/docs/references.js.map +1 -1
  309. package/dist/rules/docs/unversionedInstalls.d.ts.map +1 -1
  310. package/dist/rules/docs/unversionedInstalls.js +1 -1
  311. package/dist/rules/docs/unversionedInstalls.js.map +1 -1
  312. package/dist/rules/effect/boundary.d.ts.map +1 -1
  313. package/dist/rules/effect/boundary.js +1 -1
  314. package/dist/rules/effect/boundary.js.map +1 -1
  315. package/dist/rules/effect/failureFindings.d.ts +1 -1
  316. package/dist/rules/effect/failureFindings.d.ts.map +1 -1
  317. package/dist/rules/effect/failureFindings.js +9 -3
  318. package/dist/rules/effect/failureFindings.js.map +1 -1
  319. package/dist/rules/effect/failureHonesty.d.ts.map +1 -1
  320. package/dist/rules/effect/failureHonesty.js +3 -2
  321. package/dist/rules/effect/failureHonesty.js.map +1 -1
  322. package/dist/rules/effect/serviceParameters.js +2 -2
  323. package/dist/rules/effect/serviceParameters.js.map +1 -1
  324. package/dist/rules/effect/successRecovery.d.ts +1 -0
  325. package/dist/rules/effect/successRecovery.d.ts.map +1 -1
  326. package/dist/rules/effect/successRecovery.js +23 -0
  327. package/dist/rules/effect/successRecovery.js.map +1 -1
  328. package/dist/rules/files/packageImports.d.ts +2 -1
  329. package/dist/rules/files/packageImports.d.ts.map +1 -1
  330. package/dist/rules/files/packageImports.js +1 -1
  331. package/dist/rules/files/packageImports.js.map +1 -1
  332. package/dist/rules/files/stylesheetImporters.d.ts +2 -1
  333. package/dist/rules/files/stylesheetImporters.d.ts.map +1 -1
  334. package/dist/rules/files/stylesheetImporters.js +1 -1
  335. package/dist/rules/files/stylesheetImporters.js.map +1 -1
  336. package/dist/rules/imports/manifest.js +4 -4
  337. package/dist/rules/imports/manifest.js.map +1 -1
  338. package/dist/rules/imports/runtime.d.ts.map +1 -1
  339. package/dist/rules/imports/runtime.js +2 -3
  340. package/dist/rules/imports/runtime.js.map +1 -1
  341. package/dist/rules/manifestsApplication.d.ts.map +1 -1
  342. package/dist/rules/manifestsApplication.js +8 -9
  343. package/dist/rules/manifestsApplication.js.map +1 -1
  344. package/dist/rules/manifestsDependencyPins.js +1 -1
  345. package/dist/rules/manifestsDependencyPins.js.map +1 -1
  346. package/dist/rules/manifestsExportsShape.js +2 -2
  347. package/dist/rules/manifestsExportsShape.js.map +1 -1
  348. package/dist/rules/manifestsNoTestKits.d.ts.map +1 -1
  349. package/dist/rules/manifestsNoTestKits.js +1 -1
  350. package/dist/rules/manifestsNoTestKits.js.map +1 -1
  351. package/dist/rules/manifestsSorted.js +2 -2
  352. package/dist/rules/manifestsSorted.js.map +1 -1
  353. package/dist/rules/manifestsSourceFirst.js +1 -1
  354. package/dist/rules/manifestsSourceFirst.js.map +1 -1
  355. package/dist/rules/manifestsValid.d.ts.map +1 -1
  356. package/dist/rules/manifestsValid.js +1 -1
  357. package/dist/rules/manifestsValid.js.map +1 -1
  358. package/dist/rules/stories/authSql.js +1 -1
  359. package/dist/rules/stories/authSql.js.map +1 -1
  360. package/dist/rules/stories/engine.js +1 -1
  361. package/dist/rules/stories/engine.js.map +1 -1
  362. package/dist/rules/stories/prerequisites.d.ts +2 -1
  363. package/dist/rules/stories/prerequisites.d.ts.map +1 -1
  364. package/dist/rules/stories/prerequisites.js +4 -3
  365. package/dist/rules/stories/prerequisites.js.map +1 -1
  366. package/dist/rules/stories/queueSql.d.ts.map +1 -1
  367. package/dist/rules/stories/queueSql.js +3 -2
  368. package/dist/rules/stories/queueSql.js.map +1 -1
  369. package/dist/rules/stories/sources.d.ts +2 -2
  370. package/dist/rules/stories/sources.d.ts.map +1 -1
  371. package/dist/rules/stories/sources.js +1 -1
  372. package/dist/rules/stories/sources.js.map +1 -1
  373. package/dist/rules/stories/specs.js +1 -1
  374. package/dist/rules/stories/specs.js.map +1 -1
  375. package/dist/rules/stories/sqlText.d.ts +3 -1
  376. package/dist/rules/stories/sqlText.d.ts.map +1 -1
  377. package/dist/rules/stories/sqlText.js +12 -11
  378. package/dist/rules/stories/sqlText.js.map +1 -1
  379. package/dist/rules/suppressions/biome/declarations.d.ts +1 -1
  380. package/dist/rules/suppressions/biome/declarations.d.ts.map +1 -1
  381. package/dist/rules/suppressions/biome/declarations.js +1 -1
  382. package/dist/rules/suppressions/biome/declarations.js.map +1 -1
  383. package/dist/rules/suppressions/biomeOverrides.js +1 -1
  384. package/dist/rules/suppressions/biomeOverrides.js.map +1 -1
  385. package/dist/rules/suppressions/noDoubleCast.js +1 -1
  386. package/dist/rules/suppressions/noDoubleCast.js.map +1 -1
  387. package/dist/rules/suppressions/noInline.d.ts.map +1 -1
  388. package/dist/rules/suppressions/noInline.js +11 -4
  389. package/dist/rules/suppressions/noInline.js.map +1 -1
  390. package/dist/rules/suppressions/readonlyWrite.d.ts.map +1 -1
  391. package/dist/rules/suppressions/readonlyWrite.js +2 -1
  392. package/dist/rules/suppressions/readonlyWrite.js.map +1 -1
  393. package/dist/testing/adapters/cli.js +1 -1
  394. package/dist/testing/adapters/cli.js.map +1 -1
  395. package/dist/testing/adapters/imports.js +2 -2
  396. package/dist/testing/adapters/imports.js.map +1 -1
  397. package/dist/testing/adapters/run.js +1 -1
  398. package/dist/testing/adapters/run.js.map +1 -1
  399. package/dist/testing/adapters/tree.d.ts +1 -0
  400. package/dist/testing/adapters/tree.d.ts.map +1 -1
  401. package/dist/testing/adapters/tree.js +3 -0
  402. package/dist/testing/adapters/tree.js.map +1 -1
  403. package/dist/testing/ruleStory.js +1 -1
  404. package/dist/testing/ruleStory.js.map +1 -1
  405. package/docs/debt-and-hooks.md +3 -1
  406. package/package.json +5 -5
  407. package/src/adapters/asciiFindings.ts +1 -1
  408. package/src/adapters/biome/configs.ts +50 -28
  409. package/src/adapters/biome/presetConfig.ts +5 -5
  410. package/src/adapters/biome/resolvePackage.ts +5 -4
  411. package/src/adapters/biome/rootConfig.ts +7 -3
  412. package/src/adapters/biome/toolContractDefaults.ts +4 -5
  413. package/src/adapters/builtinName.ts +10 -0
  414. package/src/adapters/catalogWorkspace.ts +1 -1
  415. package/src/adapters/commandLine.ts +10 -0
  416. package/src/adapters/contentHashedModule.ts +9 -0
  417. package/src/adapters/freshObject.ts +61 -0
  418. package/src/adapters/imports/resolve.ts +2 -1
  419. package/src/adapters/knip/configuration.ts +17 -9
  420. package/src/adapters/knip/entryPointFindings.ts +7 -7
  421. package/src/adapters/knip/run.ts +2 -2
  422. package/src/adapters/knip/sourceConfig.ts +1 -3
  423. package/src/adapters/manifestInventory.ts +37 -32
  424. package/src/adapters/manifestReader.ts +4 -5
  425. package/src/adapters/manifestSorting.ts +8 -0
  426. package/src/adapters/outsideImportFindings.ts +5 -3
  427. package/src/adapters/queueReadoutFindings.ts +1 -1
  428. package/src/adapters/repositoryPathFindings.ts +1 -1
  429. package/src/adapters/rule.ts +3 -4
  430. package/src/adapters/serviceIdFindings.ts +1 -1
  431. package/src/adapters/sharedErrorFindings.ts +1 -1
  432. package/src/adapters/sharedErrorModules.ts +4 -3
  433. package/src/adapters/testProjects.ts +2 -2
  434. package/src/appTestConfig.ts +4 -4
  435. package/src/baseline/format.ts +2 -2
  436. package/src/baseline/legacy.ts +2 -2
  437. package/src/baseline/looseStagedEntries.ts +2 -2
  438. package/src/baseline/merge.ts +1 -1
  439. package/src/biome/withoutEntryPointImports.ts +2 -2
  440. package/src/cli/args.ts +3 -6
  441. package/src/cli/lint.ts +24 -16
  442. package/src/cli/migrateBaseline.ts +1 -3
  443. package/src/cli/migrateExceptions.ts +10 -11
  444. package/src/cli.ts +1 -1
  445. package/src/config/decode.ts +1 -1
  446. package/src/config/load.ts +1 -1
  447. package/src/decoded.ts +4 -6
  448. package/src/docs/importFindings.ts +5 -4
  449. package/src/docs/linkFindings.ts +8 -3
  450. package/src/engine/baselineFile.ts +1 -1
  451. package/src/engine/session.ts +3 -3
  452. package/src/exceptions/MigrationFailure.ts +5 -0
  453. package/src/exceptions/biomeFindings.ts +7 -3
  454. package/src/exceptions/declaration.ts +1 -1
  455. package/src/exceptions/migrateBiome.ts +10 -4
  456. package/src/exceptions/migrateConfig.ts +66 -29
  457. package/src/exceptions/registry.ts +2 -2
  458. package/src/hooks/preCommit.ts +12 -11
  459. package/src/imports/browserGlobals.ts +8 -2
  460. package/src/imports/browserNames.ts +13 -5
  461. package/src/imports/departures.ts +1 -1
  462. package/src/imports/fences/BoundaryFailure.ts +6 -0
  463. package/src/imports/fences/check.ts +2 -2
  464. package/src/imports/fences/compilePolicy.ts +5 -3
  465. package/src/imports/fences/discover.ts +41 -26
  466. package/src/imports/fences/match.ts +2 -1
  467. package/src/imports/globMatcher.ts +51 -50
  468. package/src/imports/graph.ts +1 -1
  469. package/src/imports/packageName.ts +1 -10
  470. package/src/imports/pnpmWorkspacePatterns.ts +44 -39
  471. package/src/imports/runtime.ts +3 -4
  472. package/src/imports/segmentsMatch.ts +19 -0
  473. package/src/imports/withoutGenerated.ts +1 -1
  474. package/src/imports/workspace.ts +25 -17
  475. package/src/manifests/deliveredDependencies.ts +11 -0
  476. package/src/manifests/entryPoints.ts +25 -13
  477. package/src/manifests/sorted.ts +5 -16
  478. package/src/naming/developmentCode.ts +2 -2
  479. package/src/naming/packageLayout.ts +6 -6
  480. package/src/naming/packageTests.ts +2 -2
  481. package/src/naming/testCode.ts +8 -11
  482. package/src/report/recap.ts +29 -0
  483. package/src/report/render.ts +1 -1
  484. package/src/rule.ts +2 -2
  485. package/src/rules/biome.ts +1 -1
  486. package/src/rules/docs/references.ts +8 -15
  487. package/src/rules/docs/unversionedInstalls.ts +1 -4
  488. package/src/rules/effect/boundary.ts +16 -19
  489. package/src/rules/effect/failureFindings.ts +12 -3
  490. package/src/rules/effect/failureHonesty.ts +3 -2
  491. package/src/rules/effect/serviceParameters.ts +2 -2
  492. package/src/rules/effect/successRecovery.ts +26 -0
  493. package/src/rules/files/packageImports.ts +3 -6
  494. package/src/rules/files/stylesheetImporters.ts +3 -6
  495. package/src/rules/imports/manifest.ts +6 -6
  496. package/src/rules/imports/runtime.ts +2 -3
  497. package/src/rules/manifestsApplication.ts +12 -14
  498. package/src/rules/manifestsDependencyPins.ts +1 -1
  499. package/src/rules/manifestsExportsShape.ts +2 -2
  500. package/src/rules/manifestsNoTestKits.ts +1 -4
  501. package/src/rules/manifestsSorted.ts +2 -2
  502. package/src/rules/manifestsSourceFirst.ts +1 -1
  503. package/src/rules/manifestsValid.ts +2 -3
  504. package/src/rules/stories/authSql.ts +1 -1
  505. package/src/rules/stories/engine.ts +1 -1
  506. package/src/rules/stories/prerequisites.ts +4 -3
  507. package/src/rules/stories/queueSql.ts +12 -9
  508. package/src/rules/stories/sources.ts +1 -1
  509. package/src/rules/stories/specs.ts +1 -1
  510. package/src/rules/stories/sqlText.ts +16 -12
  511. package/src/rules/suppressions/biome/declarations.ts +2 -2
  512. package/src/rules/suppressions/biomeOverrides.ts +1 -1
  513. package/src/rules/suppressions/noDoubleCast.ts +1 -1
  514. package/src/rules/suppressions/noInline.ts +15 -7
  515. package/src/rules/suppressions/readonlyWrite.ts +2 -1
  516. package/src/testing/adapters/cli.ts +1 -1
  517. package/src/testing/adapters/imports.ts +2 -2
  518. package/src/testing/adapters/run.ts +1 -1
  519. package/src/testing/adapters/tree.ts +4 -0
  520. package/src/testing/ruleStory.ts +1 -1
  521. package/dist/cli/runMain.d.ts.map +0 -1
  522. package/dist/cli/runMain.js.map +0 -1
  523. package/dist/domEnvironment.config.d.ts.map +0 -1
  524. package/dist/domEnvironment.config.js.map +0 -1
  525. package/dist/unitIoGuard.config.d.ts.map +0 -1
  526. package/dist/unitIoGuard.config.js.map +0 -1
  527. /package/dist/{domEnvironment.config.d.ts → adapters/domEnvironment.config.d.ts} +0 -0
  528. /package/dist/{domEnvironment.config.js → adapters/domEnvironment.config.js} +0 -0
  529. /package/dist/{cli → adapters}/runMain.d.ts +0 -0
  530. /package/dist/{cli → adapters}/runMain.js +0 -0
  531. /package/dist/{unitIoGuard.config.d.ts → adapters/unitIoGuard.config.d.ts} +0 -0
  532. /package/dist/{unitIoGuard.config.js → adapters/unitIoGuard.config.js} +0 -0
  533. /package/src/{domEnvironment.config.ts → adapters/domEnvironment.config.ts} +0 -0
  534. /package/src/{cli → adapters}/runMain.ts +0 -0
  535. /package/src/{unitIoGuard.config.ts → adapters/unitIoGuard.config.ts} +0 -0
@@ -5,8 +5,8 @@ import type { RuleInputs } from "#rule.ts";
5
5
 
6
6
  export const packageTests = Effect.fn("Tests.packageTests")(function* (inputs: RuleInputs) {
7
7
  const posix = yield* Path.Path.pipe(Effect.provide(Path.layer));
8
- const packages = [...(yield* Effect.promise(() => workspacePackages(inputs)))];
9
- if ((yield* Effect.promise(() => readPackageManifest(inputs.readText, "package.json"))) !== undefined) {
8
+ const packages = [...(yield* workspacePackages(inputs))];
9
+ if ((yield* readPackageManifest(inputs.readText, "package.json")) !== undefined) {
10
10
  packages.push({ directory: ".", name: "." });
11
11
  }
12
12
  const withSource = new Set(
@@ -17,17 +17,14 @@ export const testCode = Effect.fn("Tests.testCode")(function* (inputs: RuleInput
17
17
  return isTestCode(path) || trees.sourcePath(path) !== undefined;
18
18
  }
19
19
  const policies = yield* Effect.forEach(trees.packages, (owner) =>
20
- Effect.map(
21
- Effect.promise(() => readPackageManifest(inputs.readText, posix.join(owner.directory, "package.json"))),
22
- (manifest) => ({
23
- owner,
24
- private: manifest?.private === true && manifest.bin === undefined && owner.directory !== ".",
25
- scripts: scriptPaths(
26
- owner.directory,
27
- Object.fromEntries(Object.entries(manifest?.scripts ?? {}).filter(([name]) => !/^test(?::|$)/u.test(name))),
28
- ),
29
- }),
30
- ),
20
+ Effect.map(readPackageManifest(inputs.readText, posix.join(owner.directory, "package.json")), (manifest) => ({
21
+ owner,
22
+ private: manifest?.private === true && manifest.bin === undefined && owner.directory !== ".",
23
+ scripts: scriptPaths(
24
+ owner.directory,
25
+ Object.fromEntries(Object.entries(manifest?.scripts ?? {}).filter(([name]) => !/^test(?::|$)/u.test(name))),
26
+ ),
27
+ })),
31
28
  );
32
29
  if (!(policies.some((policy) => policy.private) && inputs.sources.some((file) => /\.[cm]?[jt]sx?$/u.test(file.path)))) {
33
30
  return testFile;
@@ -0,0 +1,29 @@
1
+ import type { Outcome } from "#engine/evaluate.ts";
2
+ import { groupBy } from "#engine/violation.ts";
3
+ import { plural } from "#report/plural.ts";
4
+ import { failures, type ReportContext } from "#report/render.ts";
5
+
6
+ const FILES_SHOWN = 3;
7
+
8
+ function firstFiles(files: readonly string[]): string {
9
+ const distinct = [...new Set(files)];
10
+ const shown = distinct.slice(0, FILES_SHOWN).join(", ");
11
+ return distinct.length > FILES_SHOWN ? `${shown} and ${plural(distinct.length - FILES_SHOWN, "more file")}` : shown;
12
+ }
13
+
14
+ function staleLine(file: string, entries: readonly { readonly entry: { readonly file: string } }[]): readonly string[] {
15
+ return entries.length === 0
16
+ ? []
17
+ : [` error ${file} (${plural(entries.length, "stale entry", "stale entries")}): ${firstFiles(entries.map(({ entry }) => entry.file))}`];
18
+ }
19
+
20
+ export function recap(outcome: Outcome, context: ReportContext): string {
21
+ return [
22
+ `quality lint failed with ${failures(outcome)}:`,
23
+ ...[...groupBy(outcome.errors, (violation) => violation.rule).entries()].map(
24
+ ([rule, inRule]) => ` error ${rule} (${inRule.length}): ${firstFiles(inRule.map((violation) => violation.file))}`,
25
+ ),
26
+ ...staleLine(context.baseline, outcome.staleBaseline),
27
+ ...staleLine(context.registry, outcome.staleRegistry),
28
+ ].join("\n");
29
+ }
@@ -41,7 +41,7 @@ function ruleSections(violations: readonly Violation[], context: ReportContext,
41
41
  );
42
42
  }
43
43
 
44
- function failures(outcome: Outcome): string {
44
+ export function failures(outcome: Outcome): string {
45
45
  const stale = outcome.staleBaseline.length + outcome.staleRegistry.length;
46
46
  return [
47
47
  ...(outcome.errors.length > 0 ? [plural(outcome.errors.length, "error")] : []),
package/src/rule.ts CHANGED
@@ -3,6 +3,7 @@ import type { ChildProcessSpawner } from "effect/process";
3
3
  import { configureWith, noOptions, type RuleCheckResult, ruleConfiguration } from "#adapters/rule.ts";
4
4
  import type { StandardSchemaV1 } from "#adapters/standardSchema.ts";
5
5
  import type { ExceptionDeclaration } from "#exceptions/declaration.ts";
6
+ import type { FilesystemFailure } from "#inventory/filesystem.ts";
6
7
 
7
8
  export interface Finding {
8
9
  readonly count?: number | undefined;
@@ -28,9 +29,8 @@ export interface RuleInputs {
28
29
  readonly exceptions?: readonly ExceptionDeclaration[];
29
30
  readonly files: readonly string[];
30
31
  readonly nonEffectFolders?: readonly string[];
31
- readonly readText: (path: string) => Promise<string | undefined>;
32
+ readonly readText: (path: string) => Effect.Effect<string | undefined, FilesystemFailure>;
32
33
  readonly root: string;
33
- readonly signal?: AbortSignal;
34
34
  readonly sources: readonly SourceFile[];
35
35
  }
36
36
 
@@ -24,7 +24,7 @@ function findingOf(diagnostic: Diagnostic): Finding {
24
24
  }
25
25
 
26
26
  const presetFinding = Effect.fn("Biome.presetFinding")(function* (inputs: Pick<RuleInputs, "readText">) {
27
- const { extendsPreset, path } = yield* Effect.promise(() => rootConfig(inputs.readText));
27
+ const { extendsPreset, path } = yield* rootConfig(inputs.readText);
28
28
  return extendsPreset ? [] : [{ file: path, message: `Extend "${PRESET}" from the root Biome config.`, subject: "preset" }];
29
29
  });
30
30
 
@@ -9,6 +9,7 @@ import { linkFindings } from "#docs/linkFindings.ts";
9
9
  import { markdownLines } from "#docs/markdownLines.ts";
10
10
  import { repositoryOf } from "#docs/repositoryLink.ts";
11
11
  import { type WorkspacePackage, workspacePackages } from "#imports/workspace.ts";
12
+ import type { FilesystemFailure } from "#inventory/filesystem.ts";
12
13
  import { defineRule, type Finding, type RuleInputs } from "#rule.ts";
13
14
 
14
15
  function field(value: unknown, key: string): unknown {
@@ -21,11 +22,7 @@ function isLink(root: string, file: string): boolean {
21
22
  return real(join(root, file)) !== join(real(root), file);
22
23
  }
23
24
 
24
- function reader(inputs: RuleInputs): (path: string) => Effect.Effect<string | undefined> {
25
- return (path) => Effect.promise(() => inputs.readText(path));
26
- }
27
-
28
- function anchorsReader(read: ReturnType<typeof reader>): (path: string) => Effect.Effect<ReadonlySet<string> | undefined> {
25
+ function anchorsReader(read: RuleInputs["readText"]): (path: string) => Effect.Effect<ReadonlySet<string> | undefined, FilesystemFailure> {
29
26
  const known = new Map<string, ReadonlySet<string> | undefined>();
30
27
  return (path) =>
31
28
  known.has(path)
@@ -38,27 +35,23 @@ function anchorsReader(read: ReturnType<typeof reader>): (path: string) => Effec
38
35
  }
39
36
 
40
37
  const references = Effect.fn("Docs.references")(function* (inputs: RuleInputs) {
41
- const read = reader(inputs);
42
- const packages: readonly WorkspacePackage[] = yield* Effect.promise(() => workspacePackages(inputs));
38
+ const packages: readonly WorkspacePackage[] = yield* workspacePackages(inputs);
43
39
  const manifests = new Map(
44
40
  yield* Effect.forEach(packages, (owner) =>
45
- Effect.map(
46
- Effect.promise(() => readPackageManifest(inputs.readText, posix.join(owner.directory, "package.json"))),
47
- (manifest) => [owner.name, manifest] as const,
48
- ),
41
+ Effect.map(readPackageManifest(inputs.readText, posix.join(owner.directory, "package.json")), (manifest) => [owner.name, manifest] as const),
49
42
  ),
50
43
  );
51
44
  const shared = {
52
- anchors: anchorsReader(read),
45
+ anchors: anchorsReader(inputs.readText),
53
46
  exports: new Map([...manifests].map(([name, manifest]) => [name, field(manifest, "exports")])),
54
47
  packages: new Map(packages.map((owner) => [owner.name, owner])),
55
- readText: read,
56
- repository: repositoryOf(yield* Effect.promise(() => readPackageManifest(inputs.readText, "package.json"))),
48
+ readText: inputs.readText,
49
+ repository: repositoryOf(yield* readPackageManifest(inputs.readText, "package.json")),
57
50
  root: inputs.root,
58
51
  };
59
52
  const documents = inputs.files.filter((file) => isDocument(file) && !isLink(inputs.root, file));
60
53
  const findings = yield* Effect.forEach(documents, (file) =>
61
- Effect.flatMap(read(file), (text): Effect.Effect<readonly Finding[]> => {
54
+ Effect.flatMap(inputs.readText(file), (text): Effect.Effect<readonly Finding[], FilesystemFailure> => {
62
55
  if (text === undefined) {
63
56
  return Effect.succeed([]);
64
57
  }
@@ -37,10 +37,7 @@ function findingsIn(file: string, text: string): readonly Finding[] {
37
37
 
38
38
  const unversionedInstalls = Effect.fn("Docs.unversionedInstalls")(function* (inputs: RuleInputs) {
39
39
  const findings = yield* Effect.forEach(inputs.files.filter(isDocument), (file) =>
40
- Effect.map(
41
- Effect.promise(() => inputs.readText(file)),
42
- (text) => (text === undefined ? [] : findingsIn(file, text)),
43
- ),
40
+ Effect.map(inputs.readText(file), (text) => (text === undefined ? [] : findingsIn(file, text))),
44
41
  );
45
42
  return findings.flat();
46
43
  });
@@ -80,26 +80,23 @@ function checkBoundary(inputs: RuleInputs): readonly Finding[] {
80
80
 
81
81
  export const effectBoundary = defineRule({
82
82
  check: (inputs) =>
83
- Effect.map(
84
- Effect.promise(() => workspacePackages(inputs)),
85
- (packages) => {
86
- const groups = new Map<string, RuleInputs["sources"][number][]>();
87
- for (const source of inputs.sources) {
88
- if (
89
- /(?:^|\/)(?:adapters|test-support)\//u.test(source.path)
90
- || !/\.[cm]?[jt]sx?$/u.test(source.path)
91
- || isPackageRootConfig(packageOf(packages, source.path)?.directory ?? ".", source.path)
92
- ) {
93
- continue;
94
- }
95
- const group = /^(?:packages|examples)\/[^/]+/u.exec(source.path)?.[0] ?? ".";
96
- const sources = groups.get(group) ?? [];
97
- sources.push(source);
98
- groups.set(group, sources);
83
+ Effect.map(workspacePackages(inputs), (packages) => {
84
+ const groups = new Map<string, RuleInputs["sources"][number][]>();
85
+ for (const source of inputs.sources) {
86
+ if (
87
+ /(?:^|\/)(?:adapters|test-support)\//u.test(source.path)
88
+ || !/\.[cm]?[jt]sx?$/u.test(source.path)
89
+ || isPackageRootConfig(packageOf(packages, source.path)?.directory ?? ".", source.path)
90
+ ) {
91
+ continue;
99
92
  }
100
- return [...groups.values()].flatMap((sources) => checkBoundary({ ...inputs, sources }));
101
- },
102
- ),
93
+ const group = /^(?:packages|examples)\/[^/]+/u.exec(source.path)?.[0] ?? ".";
94
+ const sources = groups.get(group) ?? [];
95
+ sources.push(source);
96
+ groups.set(group, sources);
97
+ }
98
+ return [...groups.values()].flatMap((sources) => checkBoundary({ ...inputs, sources }));
99
+ }),
103
100
  description:
104
101
  "Use Effect instead of Promise syntax and parameters, synchronous Node IO, throwing helper calls or Effect.sync with throwing APIs. Runners belong at entry points (including main.tsx and entry.tsx), tool configs and tests. Within Effect code, adapters/ and test-support/ folders and tool configs directly in a package's folder, which their tool loads from that fixed path, are exempt; calls to throwing helpers defined in adapters/ are accepted. Use Effect services and tagged errors; bridge outside libraries in adapters/. No config exceptions or inline suppressions; baseline existing debt.",
105
102
  id: "effect/boundary",
@@ -1,6 +1,6 @@
1
1
  import ts from "typescript";
2
2
  import { effectName, type FailureOperation, failureOperations, fileSystemCall } from "#rules/effect/failureOperations.ts";
3
- import { successRecovery } from "#rules/effect/successRecovery.ts";
3
+ import { successRecovery, translatesFailure } from "#rules/effect/successRecovery.ts";
4
4
 
5
5
  interface FailureFinding {
6
6
  readonly message: string;
@@ -30,7 +30,11 @@ function operationFailure(checker: ts.TypeChecker, operation: FailureOperation,
30
30
  return undefined;
31
31
  }
32
32
 
33
- export function failureFindings(checker: ts.TypeChecker, node: ts.CallExpression): readonly FailureFinding[] {
33
+ function storyReadout(checker: ts.TypeChecker, name: string | undefined, handler: ts.Node, testSupport: boolean): boolean {
34
+ return testSupport && (name === "catch" || name === "catchAll") && translatesFailure(checker, handler);
35
+ }
36
+
37
+ export function failureFindings(checker: ts.TypeChecker, node: ts.CallExpression, testSupport: boolean): readonly FailureFinding[] {
34
38
  const findings: FailureFinding[] = [];
35
39
  const name = effectName(checker, node.expression);
36
40
  if (name === "retry" && unboundedRetry(node)) {
@@ -41,7 +45,12 @@ export function failureFindings(checker: ts.TypeChecker, node: ts.CallExpression
41
45
  });
42
46
  }
43
47
  const handler = node.arguments.at(-1);
44
- if (["catch", "catchAll", "catchCause", "catchAllCause"].includes(name ?? "") && handler !== undefined && successRecovery(checker, handler)) {
48
+ if (
49
+ ["catch", "catchAll", "catchCause", "catchAllCause"].includes(name ?? "")
50
+ && handler !== undefined
51
+ && successRecovery(checker, handler)
52
+ && !storyReadout(checker, name, handler, testSupport)
53
+ ) {
45
54
  findings.push({
46
55
  message:
47
56
  "Catch turns every failure into success. Catch a named reason with catchTag or catchIf and re-fail the rest, or model an explicit unavailable state.",
@@ -9,6 +9,7 @@ function checkFailures(inputs: RuleInputs): readonly Finding[] {
9
9
  const checker = program.getTypeChecker();
10
10
  return inputs.sources.flatMap((file) => {
11
11
  const source = program.getSourceFile(join(inputs.root, file.path));
12
+ const testSupport = /(?:^|\/)test-support\//u.test(file.path);
12
13
  const findings: Finding[] = [];
13
14
  const reported = new Set<string>();
14
15
  function report(node: ts.Node, message: string): void {
@@ -20,7 +21,7 @@ function checkFailures(inputs: RuleInputs): readonly Finding[] {
20
21
  }
21
22
  function visit(node: ts.Node): void {
22
23
  if (ts.isCallExpression(node)) {
23
- for (const finding of failureFindings(checker, node)) {
24
+ for (const finding of failureFindings(checker, node, testSupport)) {
24
25
  report(finding.node, finding.message);
25
26
  }
26
27
  }
@@ -53,7 +54,7 @@ export const failureHonesty = defineRule({
53
54
  return [...groups.values()].flatMap((sources) => checkFailures({ ...inputs, sources }));
54
55
  },
55
56
  description:
56
- "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. No config exceptions or inline suppressions; baseline existing debt.",
57
+ "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.",
57
58
  id: "effect/failure-honesty",
58
59
  registrable: false,
59
60
  });
@@ -9,8 +9,8 @@ import { serviceFindings } from "#rules/effect/serviceFindings.ts";
9
9
 
10
10
  export const serviceParameters = defineRule({
11
11
  check: Effect.fn("Services.check")(function* (inputs: RuleInputs) {
12
- const packages = yield* Effect.promise(() => workspacePackages(inputs));
13
- const root = yield* Effect.promise(() => readPackageManifest(inputs.readText, "package.json"));
12
+ const packages = yield* workspacePackages(inputs);
13
+ const root = yield* readPackageManifest(inputs.readText, "package.json");
14
14
  const names = [...packages.map((owner) => owner.name), ...(root?.name === undefined ? [] : [root.name])];
15
15
  const groups = new Map<string, RuleInputs["sources"][number][]>();
16
16
  for (const source of inputs.sources) {
@@ -42,3 +42,29 @@ export function successRecovery(checker: ts.TypeChecker, handler: ts.Node, seen
42
42
  return ts.isFunctionDeclaration(declaration) && successRecovery(checker, declaration, seen);
43
43
  });
44
44
  }
45
+
46
+ function mentions(checker: ts.TypeChecker, node: ts.Node, symbol: ts.Symbol): boolean {
47
+ if (ts.isIdentifier(node) && checker.getSymbolAtLocation(node) === symbol) {
48
+ return true;
49
+ }
50
+ return ts.forEachChild(node, (child) => mentions(checker, child, symbol) || undefined) ?? false;
51
+ }
52
+
53
+ function derivesFrom(checker: ts.TypeChecker, value: ts.Node, error: ts.Symbol): boolean {
54
+ if (ts.isParenthesizedExpression(value)) {
55
+ return derivesFrom(checker, value.expression, error);
56
+ }
57
+ if (ts.isConditionalExpression(value)) {
58
+ return derivesFrom(checker, value.whenTrue, error) && derivesFrom(checker, value.whenFalse, error);
59
+ }
60
+ return ts.isCallExpression(value) && value.arguments.some((argument) => mentions(checker, argument, error));
61
+ }
62
+
63
+ export function translatesFailure(checker: ts.TypeChecker, handler: ts.Node): boolean {
64
+ if (!(ts.isArrowFunction(handler) || ts.isFunctionExpression(handler))) {
65
+ return false;
66
+ }
67
+ const name = handler.parameters[0]?.name;
68
+ const error = name !== undefined && ts.isIdentifier(name) ? checker.getSymbolAtLocation(name) : undefined;
69
+ return error !== undefined && returnValues(handler).every((value) => value !== undefined && derivesFrom(checker, value, error));
70
+ }
@@ -1,6 +1,6 @@
1
1
  import { posix } from "node:path";
2
2
  import { Effect } from "effect";
3
- import { readPackageManifest } from "#adapters/manifestInventory.ts";
3
+ import { type ManifestReadFailure, readPackageManifest } from "#adapters/manifestInventory.ts";
4
4
  import type { RuleInputs } from "#rule.ts";
5
5
 
6
6
  export type PackageImports = (importer: string, specifier: string) => string | undefined;
@@ -42,15 +42,12 @@ function matched(imports: unknown, specifier: string): readonly string[] {
42
42
  export const packageImports = Effect.fn("Files.packageImports")(function* ({
43
43
  files,
44
44
  readText,
45
- }: Pick<RuleInputs, "files" | "readText">): Effect.fn.Return<PackageImports> {
45
+ }: Pick<RuleInputs, "files" | "readText">): Effect.fn.Return<PackageImports, ManifestReadFailure> {
46
46
  const directories = files.filter((path) => posix.basename(path) === MANIFEST).map((path) => posix.dirname(path));
47
47
  const manifests = yield* Effect.forEach(
48
48
  directories,
49
49
  (directory) =>
50
- Effect.map(
51
- Effect.promise(() => readPackageManifest(readText, posix.join(directory, MANIFEST))),
52
- (manifest) => ({ directory, imports: manifest?.imports }),
53
- ),
50
+ Effect.map(readPackageManifest(readText, posix.join(directory, MANIFEST)), (manifest) => ({ directory, imports: manifest?.imports })),
54
51
  { concurrency: "unbounded" },
55
52
  );
56
53
  const deepestFirst = manifests.toSorted((left, right) => right.directory.length - left.directory.length);
@@ -1,6 +1,7 @@
1
1
  import { posix } from "node:path";
2
2
  import { Effect } from "effect";
3
3
  import ts from "typescript";
4
+ import type { ManifestReadFailure } from "#adapters/manifestInventory.ts";
4
5
  import type { RuleInputs, SourceFile } from "#rule.ts";
5
6
  import { type PackageImports, packageImports } from "#rules/files/packageImports.ts";
6
7
  import { parse } from "#rules/parse.ts";
@@ -44,16 +45,12 @@ function resolver(aliases: PackageImports, present: ReadonlySet<string>, fromSty
44
45
 
45
46
  export const stylesheetImporters = Effect.fn("Files.stylesheetImporters")(function* (
46
47
  inputs: Pick<RuleInputs, "files" | "readText" | "sources">,
47
- ): Effect.fn.Return<ReadonlyMap<string, readonly string[]>> {
48
+ ): Effect.fn.Return<ReadonlyMap<string, readonly string[]>, ManifestReadFailure> {
48
49
  const present = new Set(inputs.files);
49
50
  const aliases = yield* packageImports(inputs);
50
51
  const stylesheets = yield* Effect.forEach(
51
52
  inputs.files.filter((path) => STYLESHEET.test(path)),
52
- (path) =>
53
- Effect.map(
54
- Effect.promise(() => inputs.readText(path)),
55
- (text) => ({ path, text: text ?? "" }),
56
- ),
53
+ (path) => Effect.map(inputs.readText(path), (text) => ({ path, text: text ?? "" })),
57
54
  { concurrency: "unbounded" },
58
55
  );
59
56
  const fromModule = resolver(aliases, present, false);
@@ -1,9 +1,9 @@
1
1
  import { posix } from "node:path";
2
2
  import { Effect } from "effect";
3
- import { readPackageManifest } from "#adapters/manifestInventory.ts";
3
+ import { builtinName } from "#adapters/builtinName.ts";
4
+ import { type ManifestReadFailure, readPackageManifest } from "#adapters/manifestInventory.ts";
4
5
  import { type ImportGraph, importGraph } from "#imports/graph.ts";
5
6
  import { isTooling } from "#imports/isTooling.ts";
6
- import { builtinName } from "#imports/packageName.ts";
7
7
  import { packageOf, type WorkspacePackage } from "#imports/workspace.ts";
8
8
  import { dependencyNames, type EntryPoint, entryPointsOf, isApplication, provider, SHIPPED_FIELDS } from "#manifests/entryPoints.ts";
9
9
  import { developmentCode } from "#naming/developmentCode.ts";
@@ -40,9 +40,9 @@ const manifestDependencies = Effect.fn("Imports.manifestDependencies")(function*
40
40
  graph: ImportGraph,
41
41
  workspace: ReadonlyMap<string, string>,
42
42
  isTestCode: (path: string) => boolean,
43
- ): Effect.fn.Return<ManifestDependencies> {
43
+ ): Effect.fn.Return<ManifestDependencies, ManifestReadFailure> {
44
44
  const path = posix.join(owner.directory, "package.json");
45
- const manifest = yield* Effect.promise(() => readPackageManifest(inputs.readText, path));
45
+ const manifest = yield* readPackageManifest(inputs.readText, path);
46
46
  if (manifest === undefined) {
47
47
  return yield* Effect.die(new Error("the manifest is missing"));
48
48
  }
@@ -50,7 +50,7 @@ const manifestDependencies = Effect.fn("Imports.manifestDependencies")(function*
50
50
  ...bundleInputs(graph, owner, manifest, (candidate) => developmentFile(owner, candidate, isTestCode)),
51
51
  application: isApplication(manifest),
52
52
  development: new Set(dependencyNames(manifest, "devDependencies")),
53
- entryPoints: yield* Effect.promise(() => entryPointsOf(inputs, owner.directory, manifest, workspace)),
53
+ entryPoints: yield* entryPointsOf(inputs, owner.directory, manifest, workspace),
54
54
  private: Reflect.get(manifest, "private") === true,
55
55
  shipped: new Set(SHIPPED_FIELDS.flatMap((field) => dependencyNames(manifest, field))),
56
56
  };
@@ -102,7 +102,7 @@ export const importsManifest = defineRule({
102
102
  return testFile(path) || tooling(path);
103
103
  }
104
104
  const root: WorkspacePackage | undefined =
105
- (yield* Effect.promise(() => readPackageManifest(inputs.readText, "package.json"))) === undefined ? undefined : { directory: ".", name: "." };
105
+ (yield* readPackageManifest(inputs.readText, "package.json")) === undefined ? undefined : { directory: ".", name: "." };
106
106
  const owners = [...graph.packages, ...(root === undefined ? [] : [root])];
107
107
  const workspace = new Map(graph.packages.map((owner) => [owner.name, owner.directory]));
108
108
  const policies = new Map(
@@ -1,7 +1,7 @@
1
1
  import { Effect } from "effect";
2
+ import { builtinName } from "#adapters/builtinName.ts";
2
3
  import { type ImportGraph, importGraph } from "#imports/graph.ts";
3
4
  import { nodePlatformBarrels } from "#imports/nodePlatformBarrels.ts";
4
- import { builtinName } from "#imports/packageName.ts";
5
5
  import { type Runtime, runtimeDeclarationProblems, runtimeOf } from "#imports/runtime.ts";
6
6
  import { isTestCode } from "#naming/testName.ts";
7
7
  import { defineRule } from "#rule.ts";
@@ -52,8 +52,7 @@ export const importsRuntime = defineRule({
52
52
  return [...imports, ...declarations];
53
53
  }
54
54
  const { browserGlobals } = yield* Effect.promise(() => import("#imports/browserGlobals.ts"));
55
- const globals = yield* Effect.forEach(shared, browserGlobals);
56
- return [...imports, ...declarations, ...globals.flat()];
55
+ return [...imports, ...declarations, ...(yield* browserGlobals(shared))];
57
56
  }),
58
57
  description:
59
58
  "Runtime folders define client, server and shared code. A manifest's quality.runtime declares a single-runtime package whole; executable packages without runtime folders and package-root tooling are server code. Production imports use @effect/platform-node module subpaths so its barrel does not load optional integrations.",
@@ -1,8 +1,9 @@
1
1
  import { dirname, posix, relative, resolve, sep } from "node:path";
2
- import { Effect } from "effect";
3
- import { readPackageManifest } from "#adapters/manifestInventory.ts";
2
+ import { Effect, Result } from "effect";
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";
6
+ import type { FilesystemFailure } from "#inventory/filesystem.ts";
6
7
  import { DEPENDENCY_FIELDS, dependencyNames, entryPointsOf, isApplication, PLATFORM } from "#manifests/entryPoints.ts";
7
8
  import { defineRule, type Finding, type RuleInputs } from "#rule.ts";
8
9
 
@@ -28,7 +29,7 @@ function ancestors(root: string, directory: string): readonly string[] {
28
29
  const nearestWorkspace = Effect.fn("Manifests.nearestWorkspace")(function* (inputs: Pick<RuleInputs, "readText" | "root">, directory: string) {
29
30
  for (const candidate of ancestors(inputs.root, directory)) {
30
31
  const path = posix.join(relative(inputs.root, candidate).split(sep).join("/") || ".", "pnpm-workspace.yaml");
31
- const text = yield* Effect.promise(() => inputs.readText(path));
32
+ const text = yield* inputs.readText(path);
32
33
  if (text !== undefined) {
33
34
  return { path, text };
34
35
  }
@@ -40,17 +41,16 @@ const hoistFindings = Effect.fn("Manifests.hoistFindings")(function* (
40
41
  inputs: Pick<RuleInputs, "readText" | "root">,
41
42
  manifestPath: string,
42
43
  directory: string,
43
- ): Effect.fn.Return<readonly Finding[]> {
44
+ ): Effect.fn.Return<readonly Finding[], FilesystemFailure> {
44
45
  const workspace = yield* nearestWorkspace(inputs, directory);
45
46
  const target = workspace?.path ?? posix.join(directory, "pnpm-workspace.yaml");
46
47
  const repair = `Add \`${HOIST_LINE}\` to ${target} so the pieces platform brings resolve by their own names.`;
47
48
  if (workspace === undefined) {
48
49
  return [{ file: manifestPath, message: `Depends on "${PLATFORM}" without a pnpm-workspace.yaml. ${repair}`, subject: HOIST_KEY }];
49
50
  }
50
- const parsed = yield* Effect.try({ catch: (cause) => cause, try: () => pnpmWorkspaceList(workspace.text, HOIST_KEY) }).pipe(Effect.result);
51
- if (parsed._tag === "Failure") {
52
- const cause = parsed.failure;
53
- 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 }];
54
54
  }
55
55
  const patterns = parsed.success;
56
56
  const included = patterns.some((pattern) => !pattern.startsWith("!") && hoists(pattern));
@@ -69,10 +69,8 @@ const duplicateFindings = Effect.fn("Manifests.duplicateFindings")(function* (
69
69
  directory: string,
70
70
  manifest: unknown,
71
71
  workspace: ReadonlyMap<string, string>,
72
- ): Effect.fn.Return<readonly Finding[]> {
73
- const entryPoints = (yield* Effect.promise(() => entryPointsOf(inputs, directory, manifest, workspace))).filter(
74
- (entry) => entry.declared !== undefined,
75
- );
72
+ ): Effect.fn.Return<readonly Finding[], ManifestReadFailure> {
73
+ const entryPoints = (yield* entryPointsOf(inputs, directory, manifest, workspace)).filter((entry) => entry.declared !== undefined);
76
74
  return DEPENDENCY_FIELDS.flatMap((field) =>
77
75
  dependencyNames(manifest, field).flatMap((name) => {
78
76
  const entry = entryPoints.find((candidate) => candidate.provides.has(name));
@@ -92,7 +90,7 @@ const duplicateFindings = Effect.fn("Manifests.duplicateFindings")(function* (
92
90
  export const manifestsApplication = defineRule({
93
91
  check: (inputs) =>
94
92
  Effect.gen(function* () {
95
- const packages = yield* Effect.promise(() => workspacePackages(inputs));
93
+ const packages = yield* workspacePackages(inputs);
96
94
  const workspace = new Map(packages.map((owner) => [owner.name, owner.directory]));
97
95
  const directories = [".", ...packages.map((owner) => owner.directory)];
98
96
  const findings = yield* Effect.forEach(
@@ -100,7 +98,7 @@ export const manifestsApplication = defineRule({
100
98
  (directory) =>
101
99
  Effect.gen(function* () {
102
100
  const manifestPath = posix.join(directory, "package.json");
103
- const manifest = yield* Effect.promise(() => readPackageManifest(inputs.readText, manifestPath));
101
+ const manifest = yield* readPackageManifest(inputs.readText, manifestPath);
104
102
  if (!isApplication(manifest)) {
105
103
  return [];
106
104
  }
@@ -50,7 +50,7 @@ export const manifestsDependencyPins = defineRule({
50
50
  }
51
51
  }
52
52
  for (const file of manifestFiles(inputs)) {
53
- const manifest = yield* Effect.promise(() => readPackageManifest(inputs.readText, file));
53
+ const manifest = yield* readPackageManifest(inputs.readText, file);
54
54
  findings.push(
55
55
  ...SECTIONS.flatMap((section) =>
56
56
  Object.entries(manifest?.[section] ?? {}).flatMap(([name, version]) => dependencyFinding(file, section, name, version, catalogs)),
@@ -84,13 +84,13 @@ function findingsIn(file: string, exports: unknown, isPrivate: boolean): readonl
84
84
  export const manifestsExportsShape = defineRule({
85
85
  check: (inputs) =>
86
86
  Effect.gen(function* () {
87
- const packages = yield* Effect.promise(() => workspacePackages(inputs));
87
+ const packages = yield* workspacePackages(inputs);
88
88
  const files = ["package.json", ...packages.map((owner) => posix.join(owner.directory, "package.json"))];
89
89
  const findings = yield* Effect.forEach(
90
90
  files,
91
91
  (file) =>
92
92
  Effect.gen(function* () {
93
- const manifest = yield* Effect.promise(() => readPackageManifest(inputs.readText, file));
93
+ const manifest = yield* readPackageManifest(inputs.readText, file);
94
94
  if (file === "package.json" && manifest === undefined) {
95
95
  return [];
96
96
  }
@@ -60,10 +60,7 @@ export const manifestsNoTestKits = defineRule({
60
60
  check: (inputs) =>
61
61
  Effect.gen(function* () {
62
62
  const findings = yield* Effect.forEach(manifestFiles(inputs), (path) =>
63
- Effect.map(
64
- Effect.promise(() => readPackageManifest(inputs.readText, path)),
65
- (manifest) => (manifest === undefined ? [] : findingsIn(inputs, path, manifest)),
66
- ),
63
+ Effect.map(readPackageManifest(inputs.readText, path), (manifest) => (manifest === undefined ? [] : findingsIn(inputs, path, manifest))),
67
64
  );
68
65
  return findings.flat();
69
66
  }),
@@ -1,6 +1,6 @@
1
1
  import { Effect } from "effect";
2
2
  import { manifestFiles, manifestText } from "#adapters/manifestInventory.ts";
3
- import { sortingOf } from "#manifests/sorted.ts";
3
+ import { sortingOf } from "#adapters/manifestSorting.ts";
4
4
  import { defineRule } from "#rule.ts";
5
5
 
6
6
  export const manifestsSorted = defineRule({
@@ -10,7 +10,7 @@ export const manifestsSorted = defineRule({
10
10
  manifestFiles(inputs),
11
11
  (file) =>
12
12
  Effect.gen(function* () {
13
- const text = yield* Effect.promise(() => manifestText(inputs.readText, file));
13
+ const text = yield* manifestText(inputs.readText, file);
14
14
  return text === undefined || sortingOf(text)._tag === "Sorted"
15
15
  ? []
16
16
  : [{ file, message: "Keys are not in sort-package-json order. Run `quality fix`." }];
@@ -30,7 +30,7 @@ export const manifestsSourceFirst = defineRule({
30
30
  manifestFiles(inputs),
31
31
  (path) =>
32
32
  Effect.gen(function* () {
33
- const entry = yield* Effect.promise(() => manifestEntry(inputs.readText, path));
33
+ const entry = yield* manifestEntry(inputs.readText, path);
34
34
  if (entry === undefined) {
35
35
  return [];
36
36
  }
@@ -4,9 +4,8 @@ import { defineRule } from "#rule.ts";
4
4
 
5
5
  export const manifestsValid = defineRule({
6
6
  check: (inputs) =>
7
- Effect.map(
8
- Effect.promise(() => loadPackageManifests(inputs.readText, manifestFiles(inputs))),
9
- (failures) => failures.map(({ path, message }) => ({ file: path, message })),
7
+ Effect.map(loadPackageManifests(inputs.readText, manifestFiles(inputs)), (failures) =>
8
+ failures.map(({ path, message }) => ({ file: path, message })),
10
9
  ),
11
10
  description: "Every package.json is valid JSON and decodes through PackageManifest before repository rules run.",
12
11
  id: "manifests/valid",
@@ -13,7 +13,7 @@ const AuthSqlOptions = Schema.Struct({
13
13
  export const authSql = defineRule({
14
14
  check: ({ options, ...inputs }) =>
15
15
  Effect.gen(function* () {
16
- const queries = yield* Effect.promise(() => sqlTexts(inputs));
16
+ const queries = yield* sqlTexts(inputs);
17
17
  function owns(file: string): boolean {
18
18
  return matchesAny(file, globPatterns(options.owners));
19
19
  }
@@ -25,7 +25,7 @@ function ignoresEngine(call: ts.CallExpression, checker: ts.TypeChecker): boolea
25
25
  export const storyEngine = defineRule({
26
26
  check: Effect.fn("Stories.check")(function* (inputs) {
27
27
  const graph = yield* importGraph(inputs);
28
- const exempt = yield* Effect.promise(() => storyPrerequisites(inputs, graph.packages));
28
+ const exempt = yield* storyPrerequisites(inputs, graph.packages);
29
29
  const origins = storyOrigins(inputs, graph);
30
30
  return inputs.sources.flatMap((file) => {
31
31
  const name = testName(file.path);