@shivaedev/quality 0.74.3 → 0.75.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 (487) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +15 -4
  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 +8 -7
  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 +3 -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/migrateBaseline.d.ts.map +1 -1
  144. package/dist/cli/migrateBaseline.js +1 -3
  145. package/dist/cli/migrateBaseline.js.map +1 -1
  146. package/dist/cli/migrateExceptions.js +2 -2
  147. package/dist/cli/migrateExceptions.js.map +1 -1
  148. package/dist/cli.js +1 -1
  149. package/dist/cli.js.map +1 -1
  150. package/dist/config/decode.d.ts +1 -1
  151. package/dist/config/decode.d.ts.map +1 -1
  152. package/dist/config/load.js +1 -1
  153. package/dist/config/load.js.map +1 -1
  154. package/dist/decoded.d.ts +1 -1
  155. package/dist/decoded.d.ts.map +1 -1
  156. package/dist/decoded.js +2 -2
  157. package/dist/decoded.js.map +1 -1
  158. package/dist/docs/importFindings.d.ts +4 -3
  159. package/dist/docs/importFindings.d.ts.map +1 -1
  160. package/dist/docs/importFindings.js.map +1 -1
  161. package/dist/docs/linkFindings.d.ts +3 -2
  162. package/dist/docs/linkFindings.d.ts.map +1 -1
  163. package/dist/docs/linkFindings.js.map +1 -1
  164. package/dist/engine/baselineFile.js +1 -1
  165. package/dist/engine/baselineFile.js.map +1 -1
  166. package/dist/engine/session.d.ts.map +1 -1
  167. package/dist/engine/session.js +1 -1
  168. package/dist/engine/session.js.map +1 -1
  169. package/dist/exceptions/biomeFindings.d.ts +3 -2
  170. package/dist/exceptions/biomeFindings.d.ts.map +1 -1
  171. package/dist/exceptions/biomeFindings.js +2 -2
  172. package/dist/exceptions/biomeFindings.js.map +1 -1
  173. package/dist/exceptions/declaration.d.ts +1 -1
  174. package/dist/exceptions/declaration.d.ts.map +1 -1
  175. package/dist/exceptions/registry.d.ts +1 -1
  176. package/dist/exceptions/registry.d.ts.map +1 -1
  177. package/dist/exceptions/registry.js +1 -1
  178. package/dist/exceptions/registry.js.map +1 -1
  179. package/dist/hooks/preCommit.js +2 -5
  180. package/dist/hooks/preCommit.js.map +1 -1
  181. package/dist/imports/browserGlobals.d.ts +1 -1
  182. package/dist/imports/browserGlobals.d.ts.map +1 -1
  183. package/dist/imports/browserGlobals.js +7 -2
  184. package/dist/imports/browserGlobals.js.map +1 -1
  185. package/dist/imports/browserNames.d.ts +3 -1
  186. package/dist/imports/browserNames.d.ts.map +1 -1
  187. package/dist/imports/browserNames.js +9 -5
  188. package/dist/imports/browserNames.js.map +1 -1
  189. package/dist/imports/departures.d.ts +1 -1
  190. package/dist/imports/departures.d.ts.map +1 -1
  191. package/dist/imports/departures.js +1 -1
  192. package/dist/imports/departures.js.map +1 -1
  193. package/dist/imports/fences/BoundaryFailure.d.ts +10 -0
  194. package/dist/imports/fences/BoundaryFailure.d.ts.map +1 -0
  195. package/dist/imports/fences/BoundaryFailure.js +4 -0
  196. package/dist/imports/fences/BoundaryFailure.js.map +1 -0
  197. package/dist/imports/fences/check.d.ts +1 -1
  198. package/dist/imports/fences/check.d.ts.map +1 -1
  199. package/dist/imports/fences/check.js +1 -1
  200. package/dist/imports/fences/check.js.map +1 -1
  201. package/dist/imports/fences/declarations.d.ts +1 -1
  202. package/dist/imports/fences/declarations.d.ts.map +1 -1
  203. package/dist/imports/fences/discover.d.ts +3 -1
  204. package/dist/imports/fences/discover.d.ts.map +1 -1
  205. package/dist/imports/fences/discover.js +32 -26
  206. package/dist/imports/fences/discover.js.map +1 -1
  207. package/dist/imports/fences/match.d.ts.map +1 -1
  208. package/dist/imports/fences/match.js +2 -1
  209. package/dist/imports/fences/match.js.map +1 -1
  210. package/dist/imports/globMatcher.d.ts +10 -1
  211. package/dist/imports/globMatcher.d.ts.map +1 -1
  212. package/dist/imports/globMatcher.js +12 -17
  213. package/dist/imports/globMatcher.js.map +1 -1
  214. package/dist/imports/graph.d.ts +1 -1
  215. package/dist/imports/graph.d.ts.map +1 -1
  216. package/dist/imports/graph.js +1 -1
  217. package/dist/imports/graph.js.map +1 -1
  218. package/dist/imports/packageName.d.ts +0 -1
  219. package/dist/imports/packageName.d.ts.map +1 -1
  220. package/dist/imports/packageName.js +1 -8
  221. package/dist/imports/packageName.js.map +1 -1
  222. package/dist/imports/runtime.d.ts +2 -2
  223. package/dist/imports/runtime.d.ts.map +1 -1
  224. package/dist/imports/runtime.js +2 -2
  225. package/dist/imports/runtime.js.map +1 -1
  226. package/dist/imports/segmentsMatch.d.ts +5 -0
  227. package/dist/imports/segmentsMatch.d.ts.map +1 -0
  228. package/dist/imports/segmentsMatch.js +16 -0
  229. package/dist/imports/segmentsMatch.js.map +1 -0
  230. package/dist/imports/withoutGenerated.d.ts +1 -1
  231. package/dist/imports/withoutGenerated.d.ts.map +1 -1
  232. package/dist/imports/withoutGenerated.js +1 -1
  233. package/dist/imports/withoutGenerated.js.map +1 -1
  234. package/dist/imports/workspace.d.ts +2 -1
  235. package/dist/imports/workspace.d.ts.map +1 -1
  236. package/dist/imports/workspace.js +17 -15
  237. package/dist/imports/workspace.js.map +1 -1
  238. package/dist/inventory/programmaticBuilds.d.ts +1 -1
  239. package/dist/inventory/programmaticBuilds.d.ts.map +1 -1
  240. package/dist/manifests/entryPoints.d.ts +2 -1
  241. package/dist/manifests/entryPoints.d.ts.map +1 -1
  242. package/dist/manifests/entryPoints.js +9 -8
  243. package/dist/manifests/entryPoints.js.map +1 -1
  244. package/dist/manifests/sorted.d.ts +0 -7
  245. package/dist/manifests/sorted.d.ts.map +1 -1
  246. package/dist/manifests/sorted.js +3 -10
  247. package/dist/manifests/sorted.js.map +1 -1
  248. package/dist/naming/developmentCode.d.ts +1 -1
  249. package/dist/naming/developmentCode.d.ts.map +1 -1
  250. package/dist/naming/developmentCode.js +2 -2
  251. package/dist/naming/developmentCode.js.map +1 -1
  252. package/dist/naming/packageLayout.d.ts +2 -1
  253. package/dist/naming/packageLayout.d.ts.map +1 -1
  254. package/dist/naming/packageLayout.js +4 -1
  255. package/dist/naming/packageLayout.js.map +1 -1
  256. package/dist/naming/packageTests.d.ts +1 -1
  257. package/dist/naming/packageTests.d.ts.map +1 -1
  258. package/dist/naming/packageTests.js +2 -2
  259. package/dist/naming/packageTests.js.map +1 -1
  260. package/dist/naming/testCode.d.ts +1 -1
  261. package/dist/naming/testCode.d.ts.map +1 -1
  262. package/dist/naming/testCode.js +1 -1
  263. package/dist/naming/testCode.js.map +1 -1
  264. package/dist/rule.d.ts +2 -2
  265. package/dist/rule.d.ts.map +1 -1
  266. package/dist/rules/biome.js +1 -1
  267. package/dist/rules/biome.js.map +1 -1
  268. package/dist/rules/docs/references.d.ts.map +1 -1
  269. package/dist/rules/docs/references.js +6 -10
  270. package/dist/rules/docs/references.js.map +1 -1
  271. package/dist/rules/docs/unversionedInstalls.d.ts.map +1 -1
  272. package/dist/rules/docs/unversionedInstalls.js +1 -1
  273. package/dist/rules/docs/unversionedInstalls.js.map +1 -1
  274. package/dist/rules/effect/boundary.d.ts.map +1 -1
  275. package/dist/rules/effect/boundary.js +1 -1
  276. package/dist/rules/effect/boundary.js.map +1 -1
  277. package/dist/rules/effect/failureFindings.d.ts +1 -1
  278. package/dist/rules/effect/failureFindings.d.ts.map +1 -1
  279. package/dist/rules/effect/failureFindings.js +9 -3
  280. package/dist/rules/effect/failureFindings.js.map +1 -1
  281. package/dist/rules/effect/failureHonesty.d.ts.map +1 -1
  282. package/dist/rules/effect/failureHonesty.js +3 -2
  283. package/dist/rules/effect/failureHonesty.js.map +1 -1
  284. package/dist/rules/effect/serviceParameters.js +2 -2
  285. package/dist/rules/effect/serviceParameters.js.map +1 -1
  286. package/dist/rules/effect/successRecovery.d.ts +1 -0
  287. package/dist/rules/effect/successRecovery.d.ts.map +1 -1
  288. package/dist/rules/effect/successRecovery.js +23 -0
  289. package/dist/rules/effect/successRecovery.js.map +1 -1
  290. package/dist/rules/files/packageImports.d.ts +2 -1
  291. package/dist/rules/files/packageImports.d.ts.map +1 -1
  292. package/dist/rules/files/packageImports.js +1 -1
  293. package/dist/rules/files/packageImports.js.map +1 -1
  294. package/dist/rules/files/stylesheetImporters.d.ts +2 -1
  295. package/dist/rules/files/stylesheetImporters.d.ts.map +1 -1
  296. package/dist/rules/files/stylesheetImporters.js +1 -1
  297. package/dist/rules/files/stylesheetImporters.js.map +1 -1
  298. package/dist/rules/imports/manifest.js +4 -4
  299. package/dist/rules/imports/manifest.js.map +1 -1
  300. package/dist/rules/imports/runtime.d.ts.map +1 -1
  301. package/dist/rules/imports/runtime.js +2 -3
  302. package/dist/rules/imports/runtime.js.map +1 -1
  303. package/dist/rules/manifestsApplication.d.ts.map +1 -1
  304. package/dist/rules/manifestsApplication.js +4 -4
  305. package/dist/rules/manifestsApplication.js.map +1 -1
  306. package/dist/rules/manifestsDependencyPins.js +1 -1
  307. package/dist/rules/manifestsDependencyPins.js.map +1 -1
  308. package/dist/rules/manifestsExportsShape.js +2 -2
  309. package/dist/rules/manifestsExportsShape.js.map +1 -1
  310. package/dist/rules/manifestsNoTestKits.d.ts.map +1 -1
  311. package/dist/rules/manifestsNoTestKits.js +1 -1
  312. package/dist/rules/manifestsNoTestKits.js.map +1 -1
  313. package/dist/rules/manifestsSorted.js +2 -2
  314. package/dist/rules/manifestsSorted.js.map +1 -1
  315. package/dist/rules/manifestsSourceFirst.js +1 -1
  316. package/dist/rules/manifestsSourceFirst.js.map +1 -1
  317. package/dist/rules/manifestsValid.d.ts.map +1 -1
  318. package/dist/rules/manifestsValid.js +1 -1
  319. package/dist/rules/manifestsValid.js.map +1 -1
  320. package/dist/rules/stories/authSql.js +1 -1
  321. package/dist/rules/stories/authSql.js.map +1 -1
  322. package/dist/rules/stories/engine.js +1 -1
  323. package/dist/rules/stories/engine.js.map +1 -1
  324. package/dist/rules/stories/prerequisites.d.ts +2 -1
  325. package/dist/rules/stories/prerequisites.d.ts.map +1 -1
  326. package/dist/rules/stories/prerequisites.js +4 -3
  327. package/dist/rules/stories/prerequisites.js.map +1 -1
  328. package/dist/rules/stories/queueSql.d.ts.map +1 -1
  329. package/dist/rules/stories/queueSql.js +3 -2
  330. package/dist/rules/stories/queueSql.js.map +1 -1
  331. package/dist/rules/stories/sources.d.ts +2 -2
  332. package/dist/rules/stories/sources.d.ts.map +1 -1
  333. package/dist/rules/stories/sources.js +1 -1
  334. package/dist/rules/stories/sources.js.map +1 -1
  335. package/dist/rules/stories/specs.js +1 -1
  336. package/dist/rules/stories/specs.js.map +1 -1
  337. package/dist/rules/stories/sqlText.d.ts +3 -1
  338. package/dist/rules/stories/sqlText.d.ts.map +1 -1
  339. package/dist/rules/stories/sqlText.js +12 -11
  340. package/dist/rules/stories/sqlText.js.map +1 -1
  341. package/dist/rules/suppressions/biome/declarations.d.ts +1 -1
  342. package/dist/rules/suppressions/biome/declarations.d.ts.map +1 -1
  343. package/dist/rules/suppressions/biome/declarations.js +1 -1
  344. package/dist/rules/suppressions/biome/declarations.js.map +1 -1
  345. package/dist/rules/suppressions/biomeOverrides.js +1 -1
  346. package/dist/rules/suppressions/biomeOverrides.js.map +1 -1
  347. package/dist/rules/suppressions/noDoubleCast.js +1 -1
  348. package/dist/rules/suppressions/noDoubleCast.js.map +1 -1
  349. package/dist/rules/suppressions/noInline.d.ts.map +1 -1
  350. package/dist/rules/suppressions/noInline.js +11 -4
  351. package/dist/rules/suppressions/noInline.js.map +1 -1
  352. package/dist/rules/suppressions/readonlyWrite.d.ts.map +1 -1
  353. package/dist/rules/suppressions/readonlyWrite.js +2 -1
  354. package/dist/rules/suppressions/readonlyWrite.js.map +1 -1
  355. package/dist/testing/adapters/cli.js +1 -1
  356. package/dist/testing/adapters/cli.js.map +1 -1
  357. package/dist/testing/adapters/imports.js +2 -2
  358. package/dist/testing/adapters/imports.js.map +1 -1
  359. package/dist/testing/adapters/run.js +1 -1
  360. package/dist/testing/adapters/run.js.map +1 -1
  361. package/dist/testing/adapters/tree.d.ts +1 -0
  362. package/dist/testing/adapters/tree.d.ts.map +1 -1
  363. package/dist/testing/adapters/tree.js +3 -0
  364. package/dist/testing/adapters/tree.js.map +1 -1
  365. package/dist/testing/ruleStory.js +1 -1
  366. package/dist/testing/ruleStory.js.map +1 -1
  367. package/package.json +4 -4
  368. package/src/adapters/asciiFindings.ts +1 -1
  369. package/src/adapters/biome/configs.ts +50 -28
  370. package/src/adapters/biome/presetConfig.ts +5 -5
  371. package/src/adapters/biome/resolvePackage.ts +5 -4
  372. package/src/adapters/biome/rootConfig.ts +7 -3
  373. package/src/adapters/biome/toolContractDefaults.ts +4 -5
  374. package/src/adapters/builtinName.ts +10 -0
  375. package/src/adapters/catalogWorkspace.ts +1 -1
  376. package/src/adapters/commandLine.ts +10 -0
  377. package/src/adapters/contentHashedModule.ts +9 -0
  378. package/src/adapters/freshObject.ts +61 -0
  379. package/src/adapters/imports/resolve.ts +2 -1
  380. package/src/adapters/knip/configuration.ts +12 -8
  381. package/src/adapters/knip/entryPointFindings.ts +7 -7
  382. package/src/adapters/knip/run.ts +2 -2
  383. package/src/adapters/knip/sourceConfig.ts +1 -3
  384. package/src/adapters/manifestInventory.ts +37 -32
  385. package/src/adapters/manifestReader.ts +4 -5
  386. package/src/adapters/manifestSorting.ts +8 -0
  387. package/src/adapters/outsideImportFindings.ts +4 -3
  388. package/src/adapters/queueReadoutFindings.ts +1 -1
  389. package/src/adapters/repositoryPathFindings.ts +1 -1
  390. package/src/adapters/rule.ts +3 -4
  391. package/src/adapters/serviceIdFindings.ts +1 -1
  392. package/src/adapters/sharedErrorFindings.ts +1 -1
  393. package/src/adapters/sharedErrorModules.ts +4 -3
  394. package/src/adapters/testProjects.ts +2 -2
  395. package/src/appTestConfig.ts +4 -4
  396. package/src/baseline/format.ts +2 -2
  397. package/src/baseline/legacy.ts +2 -2
  398. package/src/baseline/looseStagedEntries.ts +2 -2
  399. package/src/baseline/merge.ts +1 -1
  400. package/src/biome/withoutEntryPointImports.ts +2 -2
  401. package/src/cli/args.ts +3 -6
  402. package/src/cli/migrateBaseline.ts +1 -3
  403. package/src/cli/migrateExceptions.ts +2 -2
  404. package/src/cli.ts +1 -1
  405. package/src/config/decode.ts +1 -1
  406. package/src/config/load.ts +1 -1
  407. package/src/decoded.ts +4 -6
  408. package/src/docs/importFindings.ts +5 -4
  409. package/src/docs/linkFindings.ts +8 -3
  410. package/src/engine/baselineFile.ts +1 -1
  411. package/src/engine/session.ts +3 -3
  412. package/src/exceptions/biomeFindings.ts +7 -3
  413. package/src/exceptions/declaration.ts +1 -1
  414. package/src/exceptions/registry.ts +2 -2
  415. package/src/hooks/preCommit.ts +5 -5
  416. package/src/imports/browserGlobals.ts +8 -2
  417. package/src/imports/browserNames.ts +13 -5
  418. package/src/imports/departures.ts +1 -1
  419. package/src/imports/fences/BoundaryFailure.ts +6 -0
  420. package/src/imports/fences/check.ts +1 -1
  421. package/src/imports/fences/discover.ts +41 -26
  422. package/src/imports/fences/match.ts +2 -1
  423. package/src/imports/globMatcher.ts +15 -21
  424. package/src/imports/graph.ts +1 -1
  425. package/src/imports/packageName.ts +1 -10
  426. package/src/imports/runtime.ts +3 -4
  427. package/src/imports/segmentsMatch.ts +19 -0
  428. package/src/imports/withoutGenerated.ts +1 -1
  429. package/src/imports/workspace.ts +25 -17
  430. package/src/manifests/entryPoints.ts +25 -13
  431. package/src/manifests/sorted.ts +5 -16
  432. package/src/naming/developmentCode.ts +2 -2
  433. package/src/naming/packageLayout.ts +6 -6
  434. package/src/naming/packageTests.ts +2 -2
  435. package/src/naming/testCode.ts +8 -11
  436. package/src/rule.ts +2 -2
  437. package/src/rules/biome.ts +1 -1
  438. package/src/rules/docs/references.ts +8 -15
  439. package/src/rules/docs/unversionedInstalls.ts +1 -4
  440. package/src/rules/effect/boundary.ts +16 -19
  441. package/src/rules/effect/failureFindings.ts +12 -3
  442. package/src/rules/effect/failureHonesty.ts +3 -2
  443. package/src/rules/effect/serviceParameters.ts +2 -2
  444. package/src/rules/effect/successRecovery.ts +26 -0
  445. package/src/rules/files/packageImports.ts +3 -6
  446. package/src/rules/files/stylesheetImporters.ts +3 -6
  447. package/src/rules/imports/manifest.ts +6 -6
  448. package/src/rules/imports/runtime.ts +2 -3
  449. package/src/rules/manifestsApplication.ts +8 -9
  450. package/src/rules/manifestsDependencyPins.ts +1 -1
  451. package/src/rules/manifestsExportsShape.ts +2 -2
  452. package/src/rules/manifestsNoTestKits.ts +1 -4
  453. package/src/rules/manifestsSorted.ts +2 -2
  454. package/src/rules/manifestsSourceFirst.ts +1 -1
  455. package/src/rules/manifestsValid.ts +2 -3
  456. package/src/rules/stories/authSql.ts +1 -1
  457. package/src/rules/stories/engine.ts +1 -1
  458. package/src/rules/stories/prerequisites.ts +4 -3
  459. package/src/rules/stories/queueSql.ts +12 -9
  460. package/src/rules/stories/sources.ts +1 -1
  461. package/src/rules/stories/specs.ts +1 -1
  462. package/src/rules/stories/sqlText.ts +16 -12
  463. package/src/rules/suppressions/biome/declarations.ts +2 -2
  464. package/src/rules/suppressions/biomeOverrides.ts +1 -1
  465. package/src/rules/suppressions/noDoubleCast.ts +1 -1
  466. package/src/rules/suppressions/noInline.ts +15 -7
  467. package/src/rules/suppressions/readonlyWrite.ts +2 -1
  468. package/src/testing/adapters/cli.ts +1 -1
  469. package/src/testing/adapters/imports.ts +2 -2
  470. package/src/testing/adapters/run.ts +1 -1
  471. package/src/testing/adapters/tree.ts +4 -0
  472. package/src/testing/ruleStory.ts +1 -1
  473. package/dist/cli/runMain.d.ts.map +0 -1
  474. package/dist/cli/runMain.js.map +0 -1
  475. package/dist/domEnvironment.config.d.ts.map +0 -1
  476. package/dist/domEnvironment.config.js.map +0 -1
  477. package/dist/unitIoGuard.config.d.ts.map +0 -1
  478. package/dist/unitIoGuard.config.js.map +0 -1
  479. /package/dist/{domEnvironment.config.d.ts → adapters/domEnvironment.config.d.ts} +0 -0
  480. /package/dist/{domEnvironment.config.js → adapters/domEnvironment.config.js} +0 -0
  481. /package/dist/{cli → adapters}/runMain.d.ts +0 -0
  482. /package/dist/{cli → adapters}/runMain.js +0 -0
  483. /package/dist/{unitIoGuard.config.d.ts → adapters/unitIoGuard.config.d.ts} +0 -0
  484. /package/dist/{unitIoGuard.config.js → adapters/unitIoGuard.config.js} +0 -0
  485. /package/src/{domEnvironment.config.ts → adapters/domEnvironment.config.ts} +0 -0
  486. /package/src/{cli → adapters}/runMain.ts +0 -0
  487. /package/src/{unitIoGuard.config.ts → adapters/unitIoGuard.config.ts} +0 -0
@@ -1,6 +1,7 @@
1
+ import { builtinName } from "#adapters/builtinName.ts";
1
2
  import type { Endpoint } from "#imports/Endpoint.ts";
2
3
  import type { Selector } from "#imports/fences/model.ts";
3
- import { builtinName, packageNameOf } from "#imports/packageName.ts";
4
+ import { packageNameOf } from "#imports/packageName.ts";
4
5
  import { packageOf, type WorkspacePackage } from "#imports/workspace.ts";
5
6
 
6
7
  export interface PolicyScope {
@@ -1,10 +1,11 @@
1
- type Segment = RegExp | typeof GLOBSTAR;
1
+ import { Data, Result } from "effect";
2
+ import { DOT, GLOBSTAR, type Segment, segmentsMatch } from "#imports/segmentsMatch.ts";
2
3
 
3
- const STAR = "*";
4
-
5
- const GLOBSTAR = "**";
4
+ export class GlobFailure extends Data.TaggedError("GlobFailure")<{
5
+ readonly message: string;
6
+ }> {}
6
7
 
7
- const DOT = ".";
8
+ const STAR = "*";
8
9
 
9
10
  const NO_DOT = "(?!\\.)";
10
11
 
@@ -119,24 +120,17 @@ function segmentOf(segment: string, whole: string): Segment {
119
120
  return new RegExp(`^${segment.startsWith(DOT) ? "" : NO_DOT}${source}$`, "u");
120
121
  }
121
122
 
122
- function segmentsMatch(pattern: readonly Segment[], path: readonly string[]): boolean {
123
- const [first, ...rest] = pattern;
124
- if (first === undefined) {
125
- return path.length === 0;
126
- }
127
- if (first === GLOBSTAR) {
128
- const hidden = path.findIndex((segment) => segment.startsWith(DOT));
129
- const reachable = hidden === -1 ? path.length : hidden;
130
- return [...path.keys(), path.length].some((skipped) => skipped <= reachable && segmentsMatch(rest, path.slice(skipped)));
131
- }
132
- const [head, ...tail] = path;
133
- return head !== undefined && first.test(head) && segmentsMatch(rest, tail);
123
+ function matcherOf(pattern: string): (path: string) => boolean {
124
+ const alternatives = expanded(pattern, pattern).map((alternative) => alternative.split("/").map((segment) => segmentOf(segment, pattern)));
125
+ return (path) => alternatives.some((segments) => segmentsMatch(segments, path.split("/")));
134
126
  }
135
127
 
136
- export function globMatcher(pattern: string): (path: string) => boolean {
128
+ export function globMatcher(pattern: string): Result.Result<(path: string) => boolean, GlobFailure> {
137
129
  if (pattern.includes("\\")) {
138
- throw unreadable(pattern, "escapes are not supported");
130
+ return Result.fail(new GlobFailure({ message: unreadable(pattern, "escapes are not supported").message }));
139
131
  }
140
- const alternatives = expanded(pattern, pattern).map((alternative) => alternative.split("/").map((segment) => segmentOf(segment, pattern)));
141
- return (path) => alternatives.some((segments) => segmentsMatch(segments, path.split("/")));
132
+ return Result.try({
133
+ catch: (cause) => new GlobFailure({ message: cause instanceof Error ? cause.message : String(cause) }),
134
+ try: () => matcherOf(pattern),
135
+ });
142
136
  }
@@ -34,7 +34,7 @@ const build = Effect.fn("Imports.build")(function* (inputs: RuleInputs) {
34
34
  ),
35
35
  );
36
36
  }
37
- return { ...walked, packages: yield* Effect.promise(() => workspacePackages(inputs)) };
37
+ return { ...walked, packages: yield* workspacePackages(inputs) };
38
38
  });
39
39
 
40
40
  type Graph = ReturnType<typeof build>;
@@ -1,18 +1,9 @@
1
- import { isBuiltin } from "node:module";
2
-
3
- const NODE_PREFIX = "node:";
1
+ import { builtinName } from "#adapters/builtinName.ts";
4
2
 
5
3
  const TYPES_SCOPE = "@types";
6
4
 
7
5
  const TYPES_SCOPE_SEPARATOR = "__";
8
6
 
9
- export function builtinName(specifier: string): string | undefined {
10
- if (!isBuiltin(specifier)) {
11
- return undefined;
12
- }
13
- return specifier.startsWith(NODE_PREFIX) ? specifier : `${NODE_PREFIX}${specifier}`;
14
- }
15
-
16
7
  function typedName(name: string): string {
17
8
  return name.includes(TYPES_SCOPE_SEPARATOR) ? `@${name.replace(TYPES_SCOPE_SEPARATOR, "/")}` : name;
18
9
  }
@@ -77,9 +77,8 @@ export const runtimeDeclarationProblems = Effect.fn("Imports.runtimeDeclarationP
77
77
  packages: readonly WorkspacePackage[],
78
78
  ) {
79
79
  const problems = yield* Effect.forEach([...packages, { directory: ".", name: "." }], (owner) =>
80
- Effect.flatMap(
81
- Effect.promise(() => readPackageManifest(inputs.readText, posix.join(owner.directory, "package.json"))),
82
- (manifest) => problemsFor(inputs.root, owner, manifest),
80
+ Effect.flatMap(readPackageManifest(inputs.readText, posix.join(owner.directory, "package.json")), (manifest) =>
81
+ problemsFor(inputs.root, owner, manifest),
83
82
  ),
84
83
  );
85
84
  return problems.flat();
@@ -90,7 +89,7 @@ export const runtimeOf = Effect.fn("Imports.runtimeOf")(function* (inputs: RuleI
90
89
  const manifests = new Map(
91
90
  yield* Effect.forEach(owners, (owner) =>
92
91
  Effect.map(
93
- Effect.promise(() => readPackageManifest(inputs.readText, posix.join(owner.directory, "package.json"))),
92
+ readPackageManifest(inputs.readText, posix.join(owner.directory, "package.json")),
94
93
  (manifest) => [owner.directory, manifest] as const,
95
94
  ),
96
95
  ),
@@ -0,0 +1,19 @@
1
+ export const GLOBSTAR = "**";
2
+
3
+ export const DOT = ".";
4
+
5
+ export type Segment = RegExp | typeof GLOBSTAR;
6
+
7
+ export function segmentsMatch(pattern: readonly Segment[], path: readonly string[]): boolean {
8
+ const [first, ...rest] = pattern;
9
+ if (first === undefined) {
10
+ return path.length === 0;
11
+ }
12
+ if (first === GLOBSTAR) {
13
+ const hidden = path.findIndex((segment) => segment.startsWith(DOT));
14
+ const reachable = hidden === -1 ? path.length : hidden;
15
+ return [...path.keys(), path.length].some((skipped) => skipped <= reachable && segmentsMatch(rest, path.slice(skipped)));
16
+ }
17
+ const [head, ...tail] = path;
18
+ return head !== undefined && first.test(head) && segmentsMatch(rest, tail);
19
+ }
@@ -19,7 +19,7 @@ const NODE_MODULES = "node_modules";
19
19
  const PLACEHOLDERS = new Set([".gitkeep", ".keep"]);
20
20
 
21
21
  const withIgnoreFileIn = Effect.fn("Imports.withIgnoreFileIn")(function* (reader: Reader, scope: IgnoreScope, directory: string) {
22
- const contents = yield* Effect.promise(() => reader.readText(posix.join(directory, IGNORE_FILE)));
22
+ const contents = yield* reader.readText(posix.join(directory, IGNORE_FILE));
23
23
  return contents === undefined || contents === "" ? scope : withIgnoreFile(scope, posix.join(reader.root, directory), contents);
24
24
  });
25
25
 
@@ -1,4 +1,5 @@
1
1
  import { posix } from "node:path";
2
+ import { Effect } from "effect";
2
3
  import { manifestFiles, readPackageManifest } from "#adapters/manifestInventory.ts";
3
4
  import { globMatcher } from "#imports/globMatcher.ts";
4
5
  import { pnpmWorkspacePatterns } from "#imports/pnpmWorkspacePatterns.ts";
@@ -38,31 +39,38 @@ function normalized(pattern: string): string {
38
39
  return pattern.replace(LEADING_DOT, "").replace(TRAILING_SLASHES, "");
39
40
  }
40
41
 
41
- async function memberOf(inputs: Reader): Promise<(directory: string) => boolean> {
42
- const pnpm = await inputs.readText(PNPM_WORKSPACE);
43
- const patterns = [...(pnpm === undefined ? [] : pnpmWorkspacePatterns(pnpm)), ...npmPatterns(await readPackageManifest(inputs.readText, MANIFEST))];
44
- const included = patterns.filter((pattern) => !pattern.startsWith(NEGATION)).map((pattern) => globMatcher(normalized(pattern)));
45
- const excluded = patterns
46
- .filter((pattern) => pattern.startsWith(NEGATION))
47
- .map((pattern) => globMatcher(normalized(pattern.slice(NEGATION.length))));
48
- return (directory) => included.some((matches) => matches(directory)) && !excluded.some((matches) => matches(directory));
42
+ function matchers(patterns: readonly string[]) {
43
+ return Effect.forEach(patterns, (pattern) => Effect.fromResult(globMatcher(pattern)));
49
44
  }
50
45
 
51
- export async function workspacePackages(inputs: Reader): Promise<readonly WorkspacePackage[]> {
52
- const member = await memberOf(inputs);
46
+ const memberOf = Effect.fn("Imports.memberOf")(function* (inputs: Reader) {
47
+ const pnpm = yield* inputs.readText(PNPM_WORKSPACE);
48
+ const patterns = [
49
+ ...(pnpm === undefined ? [] : pnpmWorkspacePatterns(pnpm)),
50
+ ...npmPatterns(yield* readPackageManifest(inputs.readText, MANIFEST)),
51
+ ];
52
+ const included = yield* matchers(patterns.filter((pattern) => !pattern.startsWith(NEGATION)).map(normalized));
53
+ const excluded = yield* matchers(
54
+ patterns.filter((pattern) => pattern.startsWith(NEGATION)).map((pattern) => normalized(pattern.slice(NEGATION.length))),
55
+ );
56
+ return (directory: string) => included.some((matches) => matches(directory)) && !excluded.some((matches) => matches(directory));
57
+ });
58
+
59
+ export const workspacePackages = Effect.fn("Imports.workspacePackages")(function* (inputs: Reader) {
60
+ const member = yield* memberOf(inputs);
53
61
  const manifests = manifestFiles(inputs);
54
62
  const directories = manifests
55
63
  .filter((file) => posix.basename(file) === MANIFEST && file !== MANIFEST)
56
64
  .map((manifest) => posix.dirname(manifest))
57
65
  .filter(member);
58
- const named = await Promise.all(
59
- directories.map(async (directory) => ({
60
- directory,
61
- name: field(await readPackageManifest(inputs.readText, posix.join(directory, MANIFEST)), "name"),
62
- })),
66
+ const named = yield* Effect.forEach(
67
+ directories,
68
+ (directory) =>
69
+ Effect.map(readPackageManifest(inputs.readText, posix.join(directory, MANIFEST)), (manifest) => ({ directory, name: field(manifest, "name") })),
70
+ { concurrency: "unbounded" },
63
71
  );
64
- return named.flatMap(({ directory, name }) => (typeof name === "string" ? [{ directory, name }] : []));
65
- }
72
+ return named.flatMap(({ directory, name }): readonly WorkspacePackage[] => (typeof name === "string" ? [{ directory, name }] : []));
73
+ });
66
74
 
67
75
  export function packageOf(packages: readonly WorkspacePackage[], path: string): WorkspacePackage | undefined {
68
76
  const owners = packages.filter((candidate) => path.startsWith(`${candidate.directory}/`));
@@ -1,4 +1,5 @@
1
1
  import { posix } from "node:path";
2
+ import { Effect } from "effect";
2
3
  import { readPackageManifest } from "#adapters/manifestInventory.ts";
3
4
  import type { RuleInputs } from "#rule.ts";
4
5
 
@@ -25,20 +26,25 @@ export function dependencyNames(manifest: unknown, field: string): readonly stri
25
26
  return typeof value === "object" && value !== null && !Array.isArray(value) ? Object.keys(value) : [];
26
27
  }
27
28
 
28
- async function installedManifest(inputs: Pick<RuleInputs, "readText">, directory: string, name: string, workspace: ReadonlyMap<string, string>) {
29
+ const installedManifest = Effect.fn("Manifests.installedManifest")(function* (
30
+ inputs: Pick<RuleInputs, "readText">,
31
+ directory: string,
32
+ name: string,
33
+ workspace: ReadonlyMap<string, string>,
34
+ ) {
29
35
  const candidates = [
30
36
  ...(workspace.has(name) ? [posix.join(workspace.get(name) ?? ".", "package.json")] : []),
31
37
  posix.join(directory, "node_modules", name, "package.json"),
32
38
  posix.join("node_modules", name, "package.json"),
33
39
  ];
34
40
  for (const candidate of candidates) {
35
- const manifest = await readPackageManifest(inputs.readText, candidate);
41
+ const manifest = yield* readPackageManifest(inputs.readText, candidate);
36
42
  if (manifest !== undefined) {
37
43
  return manifest;
38
44
  }
39
45
  }
40
46
  return undefined;
41
- }
47
+ });
42
48
 
43
49
  function declaration(manifest: unknown, name: string): EntryPoint["declared"] {
44
50
  if (SHIPPED_FIELDS.some((field) => dependencyNames(manifest, field).includes(name))) {
@@ -47,21 +53,27 @@ function declaration(manifest: unknown, name: string): EntryPoint["declared"] {
47
53
  return dependencyNames(manifest, "devDependencies").includes(name) ? "development" : undefined;
48
54
  }
49
55
 
50
- export function entryPointsOf(
56
+ export const entryPointsOf = Effect.fn("Manifests.entryPointsOf")(function* (
51
57
  inputs: Pick<RuleInputs, "readText">,
52
58
  directory: string,
53
59
  manifest: unknown,
54
60
  workspace: ReadonlyMap<string, string>,
55
- ): Promise<readonly EntryPoint[]> {
56
- return Promise.all(
57
- ENTRY_POINTS.map(async ({ name, testOnly }) => ({
58
- declared: declaration(manifest, name),
59
- name,
60
- provides: new Set(dependencyNames(await installedManifest(inputs, directory, name, workspace), "dependencies")),
61
- testOnly,
62
- })),
61
+ ) {
62
+ return yield* Effect.forEach(
63
+ ENTRY_POINTS,
64
+ ({ name, testOnly }) =>
65
+ Effect.map(
66
+ installedManifest(inputs, directory, name, workspace),
67
+ (installed): EntryPoint => ({
68
+ declared: declaration(manifest, name),
69
+ name,
70
+ provides: new Set(dependencyNames(installed, "dependencies")),
71
+ testOnly,
72
+ }),
73
+ ),
74
+ { concurrency: "unbounded" },
63
75
  );
64
- }
76
+ });
65
77
 
66
78
  export function isApplication(manifest: unknown): boolean {
67
79
  return DEPENDENCY_FIELDS.some((field) => dependencyNames(manifest, field).includes(PLATFORM));
@@ -1,8 +1,8 @@
1
1
  import { basename, join, relative } from "node:path";
2
- import { Effect, FileSystem, type Scope } from "effect";
3
- import { sortPackageJson } from "sort-package-json";
2
+ import { Effect, FileSystem } from "effect";
4
3
  import { ManifestFailure, manifestEntry } from "#adapters/manifestInventory.ts";
5
4
  import { manifestReader } from "#adapters/manifestReader.ts";
5
+ import { sortingOf } from "#adapters/manifestSorting.ts";
6
6
  import type { SetupFailure } from "#failure.ts";
7
7
  import { FilesystemFailure } from "#inventory/filesystem.ts";
8
8
  import { posix } from "#inventory/ignoreScope.ts";
@@ -10,8 +10,6 @@ import { skillCopies } from "#inventory/skillCopies.ts";
10
10
  import { walk } from "#inventory/walk.ts";
11
11
  import type { RuleServices } from "#rule.ts";
12
12
 
13
- export type Sorting = { readonly _tag: "Sorted" } | { readonly _tag: "Unsorted"; readonly sorted: string };
14
-
15
13
  export const manifestsIn = Effect.fn("Manifests.manifestsIn")(function* (root: string) {
16
14
  const copies = yield* skillCopies(root);
17
15
  return (yield* walk(root))
@@ -21,25 +19,16 @@ export const manifestsIn = Effect.fn("Manifests.manifestsIn")(function* (root: s
21
19
  .sort();
22
20
  });
23
21
 
24
- export function sortingOf(text: string): Sorting {
25
- const sorted = sortPackageJson(text);
26
- return sorted === text ? { _tag: "Sorted" } : { _tag: "Unsorted", sorted };
27
- }
28
-
29
22
  export const sortManifests = Effect.fn("Manifests.sortManifests")(function* (
30
23
  root: string,
31
- ): Effect.fn.Return<number, FilesystemFailure | ManifestFailure | SetupFailure, RuleServices | Scope.Scope> {
24
+ ): Effect.fn.Return<number, FilesystemFailure | ManifestFailure | SetupFailure, RuleServices> {
32
25
  const fs = yield* FileSystem.FileSystem;
33
26
  const manifests = yield* manifestsIn(root);
34
27
  const readText = yield* manifestReader(root);
35
28
  const written = yield* Effect.forEach(manifests, (path) =>
36
29
  Effect.gen(function* () {
37
30
  const absolute = join(root, path);
38
- const entry = yield* Effect.tryPromise({
39
- catch: (cause) =>
40
- cause instanceof ManifestFailure ? cause : new FilesystemFailure({ message: cause instanceof Error ? cause.message : String(cause), path }),
41
- try: () => manifestEntry(readText, path),
42
- });
31
+ const entry = yield* manifestEntry(readText, path);
43
32
  if (entry === undefined) {
44
33
  return false;
45
34
  }
@@ -58,4 +47,4 @@ export const sortManifests = Effect.fn("Manifests.sortManifests")(function* (
58
47
  ),
59
48
  );
60
49
  return written.filter(Boolean).length;
61
- }, Effect.scoped);
50
+ });
@@ -7,9 +7,9 @@ import type { RuleInputs } from "#rule.ts";
7
7
 
8
8
  export const developmentCode = Effect.fn("Naming.developmentCode")(function* (inputs: RuleInputs) {
9
9
  const posix = yield* Path.Path.pipe(Effect.provide(Path.layer));
10
- const packages = yield* Effect.promise(() => workspacePackages(inputs));
10
+ const packages = yield* workspacePackages(inputs);
11
11
  const scripts = yield* Effect.forEach([".", ...packages.map((owner) => owner.directory)], (directory) =>
12
- Effect.promise(() => readPackageManifest(inputs.readText, posix.join(directory, "package.json"))).pipe(
12
+ readPackageManifest(inputs.readText, posix.join(directory, "package.json")).pipe(
13
13
  Effect.map((manifest) => scriptPaths(directory, manifest?.scripts ?? {})),
14
14
  ),
15
15
  );
@@ -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 interface PackageLayout {
@@ -46,15 +46,15 @@ function runBy(directory: string, manifest: unknown): readonly string[] {
46
46
  export const packageLayout = Effect.fn("Naming.packageLayout")(function* ({
47
47
  files,
48
48
  readText,
49
- }: Pick<RuleInputs, "files" | "readText">): Effect.fn.Return<PackageLayout> {
49
+ }: Pick<RuleInputs, "files" | "readText">): Effect.fn.Return<PackageLayout, ManifestReadFailure> {
50
50
  const directories = ["", ...files.filter((path) => posix.basename(path) === MANIFEST).map((path) => posix.dirname(path))];
51
51
  const manifests = yield* Effect.forEach(
52
52
  [...new Set(directories)],
53
53
  (directory) =>
54
- Effect.map(
55
- Effect.promise(() => readPackageManifest(readText, directory === "" ? MANIFEST : `${directory}/${MANIFEST}`)),
56
- (manifest) => ({ directory: directory === "." ? "" : directory, manifest }),
57
- ),
54
+ Effect.map(readPackageManifest(readText, directory === "" ? MANIFEST : `${directory}/${MANIFEST}`), (manifest) => ({
55
+ directory: directory === "." ? "" : directory,
56
+ manifest,
57
+ })),
58
58
  { concurrency: "unbounded" },
59
59
  );
60
60
  const present = manifests.filter((entry) => entry.manifest !== undefined);
@@ -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;
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) {