@shivaedev/quality 0.75.0 → 0.77.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (674) hide show
  1. package/CHANGELOG.md +68 -0
  2. package/README.md +66 -60
  3. package/dist/adapters/biome/pluginContract.d.ts +1 -1
  4. package/dist/adapters/biome/pluginContract.d.ts.map +1 -1
  5. package/dist/adapters/biome/pluginContract.js +2 -5
  6. package/dist/adapters/biome/pluginContract.js.map +1 -1
  7. package/dist/adapters/biome/run.d.ts.map +1 -1
  8. package/dist/adapters/biome/run.js +2 -0
  9. package/dist/adapters/biome/run.js.map +1 -1
  10. package/dist/adapters/biome/withExceptionConfig.d.ts.map +1 -1
  11. package/dist/adapters/biome/withExceptionConfig.js +21 -4
  12. package/dist/adapters/biome/withExceptionConfig.js.map +1 -1
  13. package/dist/adapters/changeKeyCheck.d.ts +10 -0
  14. package/dist/adapters/changeKeyCheck.d.ts.map +1 -0
  15. package/dist/adapters/{changeKeyFindings.js → changeKeyCheck.js} +8 -22
  16. package/dist/adapters/changeKeyCheck.js.map +1 -0
  17. package/dist/adapters/commandLine.d.ts +2 -0
  18. package/dist/adapters/commandLine.d.ts.map +1 -1
  19. package/dist/adapters/contextCaptureCheck.d.ts +9 -0
  20. package/dist/adapters/contextCaptureCheck.d.ts.map +1 -0
  21. package/dist/adapters/contextCaptureCheck.js +91 -0
  22. package/dist/adapters/contextCaptureCheck.js.map +1 -0
  23. package/dist/adapters/databaseUrlFindings.d.ts +1 -1
  24. package/dist/adapters/databaseUrlFindings.d.ts.map +1 -1
  25. package/dist/adapters/declaration-files/initialize.d.ts +6 -0
  26. package/dist/adapters/declaration-files/initialize.d.ts.map +1 -0
  27. package/dist/adapters/declaration-files/initialize.js +4 -0
  28. package/dist/adapters/declaration-files/initialize.js.map +1 -0
  29. package/dist/adapters/declaration-files/parse.d.ts +5 -0
  30. package/dist/adapters/declaration-files/parse.d.ts.map +1 -0
  31. package/dist/adapters/declaration-files/parse.js +6 -0
  32. package/dist/adapters/declaration-files/parse.js.map +1 -0
  33. package/dist/adapters/declaration-files/reader.d.ts +5 -0
  34. package/dist/adapters/declaration-files/reader.d.ts.map +1 -0
  35. package/dist/adapters/declaration-files/reader.js +23 -0
  36. package/dist/adapters/declaration-files/reader.js.map +1 -0
  37. package/dist/adapters/declaration-files/service.d.ts +9 -0
  38. package/dist/adapters/declaration-files/service.d.ts.map +1 -0
  39. package/dist/adapters/declaration-files/service.js +14 -0
  40. package/dist/adapters/declaration-files/service.js.map +1 -0
  41. package/dist/adapters/foreignResources.d.ts.map +1 -1
  42. package/dist/adapters/foreignResources.js +0 -4
  43. package/dist/adapters/foreignResources.js.map +1 -1
  44. package/dist/adapters/import-compiler/graph.d.ts +8 -2
  45. package/dist/adapters/import-compiler/graph.d.ts.map +1 -1
  46. package/dist/adapters/import-compiler/graph.js +4 -1
  47. package/dist/adapters/import-compiler/graph.js.map +1 -1
  48. package/dist/adapters/import-compiler/service.d.ts +7 -1
  49. package/dist/adapters/import-compiler/service.d.ts.map +1 -1
  50. package/dist/adapters/imports/graph.d.ts +6 -3
  51. package/dist/adapters/imports/graph.d.ts.map +1 -1
  52. package/dist/adapters/imports/graph.js +31 -18
  53. package/dist/adapters/imports/graph.js.map +1 -1
  54. package/dist/adapters/knip/configuration.d.ts +2 -2
  55. package/dist/adapters/knip/configuration.d.ts.map +1 -1
  56. package/dist/adapters/knip/configuration.js +11 -5
  57. package/dist/adapters/knip/configuration.js.map +1 -1
  58. package/dist/adapters/knip/entryPointFindings.d.ts +1 -1
  59. package/dist/adapters/knip/entryPointFindings.d.ts.map +1 -1
  60. package/dist/adapters/knip/run.d.ts +1 -1
  61. package/dist/adapters/knip/run.d.ts.map +1 -1
  62. package/dist/adapters/knip/run.js +4 -1
  63. package/dist/adapters/knip/run.js.map +1 -1
  64. package/dist/adapters/outsideImportFindings.d.ts +5 -2
  65. package/dist/adapters/outsideImportFindings.d.ts.map +1 -1
  66. package/dist/adapters/outsideImportFindings.js +12 -52
  67. package/dist/adapters/outsideImportFindings.js.map +1 -1
  68. package/dist/adapters/queueReadoutFindings.d.ts +1 -1
  69. package/dist/adapters/queueReadoutFindings.d.ts.map +1 -1
  70. package/dist/adapters/rule.d.ts +9 -1
  71. package/dist/adapters/rule.d.ts.map +1 -1
  72. package/dist/adapters/rule.js +21 -6
  73. package/dist/adapters/rule.js.map +1 -1
  74. package/dist/adapters/runMain.d.ts +3 -4
  75. package/dist/adapters/runMain.d.ts.map +1 -1
  76. package/dist/adapters/runMain.js +2 -1
  77. package/dist/adapters/runMain.js.map +1 -1
  78. package/dist/adapters/serviceIdFindings.d.ts +1 -1
  79. package/dist/adapters/serviceIdFindings.d.ts.map +1 -1
  80. package/dist/adapters/serviceModelCheck.d.ts +9 -0
  81. package/dist/adapters/serviceModelCheck.d.ts.map +1 -0
  82. package/dist/adapters/{serviceModelFindings.js → serviceModelCheck.js} +9 -23
  83. package/dist/adapters/serviceModelCheck.js.map +1 -0
  84. package/dist/adapters/sharedErrorCatalog.d.ts +13 -0
  85. package/dist/adapters/sharedErrorCatalog.d.ts.map +1 -0
  86. package/dist/adapters/sharedErrorCatalog.js +28 -0
  87. package/dist/adapters/sharedErrorCatalog.js.map +1 -0
  88. package/dist/adapters/sharedErrorModules.d.ts +1 -1
  89. package/dist/adapters/sharedErrorModules.d.ts.map +1 -1
  90. package/dist/adapters/sharedErrorModules.js.map +1 -1
  91. package/dist/adapters/specReaderSources.d.ts +3 -2
  92. package/dist/adapters/specReaderSources.d.ts.map +1 -1
  93. package/dist/adapters/specReaderSources.js +6 -3
  94. package/dist/adapters/specReaderSources.js.map +1 -1
  95. package/dist/adapters/storyProgram.d.ts +2 -0
  96. package/dist/adapters/storyProgram.d.ts.map +1 -1
  97. package/dist/adapters/storyProgram.js +13 -3
  98. package/dist/adapters/storyProgram.js.map +1 -1
  99. package/dist/adapters/typeScriptProgram.d.ts +5 -0
  100. package/dist/adapters/typeScriptProgram.d.ts.map +1 -0
  101. package/dist/adapters/typeScriptProgram.js +43 -0
  102. package/dist/adapters/typeScriptProgram.js.map +1 -0
  103. package/dist/baseline/compare.d.ts +2 -0
  104. package/dist/baseline/compare.d.ts.map +1 -1
  105. package/dist/baseline/compare.js +43 -17
  106. package/dist/baseline/compare.js.map +1 -1
  107. package/dist/baseline/format.d.ts +1 -0
  108. package/dist/baseline/format.d.ts.map +1 -1
  109. package/dist/baseline/format.js +6 -2
  110. package/dist/baseline/format.js.map +1 -1
  111. package/dist/baseline/merge.d.ts.map +1 -1
  112. package/dist/baseline/merge.js +14 -1
  113. package/dist/baseline/merge.js.map +1 -1
  114. package/dist/baseline/rewrite.d.ts.map +1 -1
  115. package/dist/baseline/rewrite.js +3 -1
  116. package/dist/baseline/rewrite.js.map +1 -1
  117. package/dist/baseline/update.d.ts +7 -0
  118. package/dist/baseline/update.d.ts.map +1 -1
  119. package/dist/baseline/update.js +29 -8
  120. package/dist/baseline/update.js.map +1 -1
  121. package/dist/biome/exceptionConfig.d.ts +3 -0
  122. package/dist/biome/exceptionConfig.d.ts.map +1 -1
  123. package/dist/biome/exceptionConfig.js +15 -1
  124. package/dist/biome/exceptionConfig.js.map +1 -1
  125. package/dist/biome/scannerRules.d.ts +3 -0
  126. package/dist/biome/scannerRules.d.ts.map +1 -0
  127. package/dist/biome/scannerRules.js +42 -0
  128. package/dist/biome/scannerRules.js.map +1 -0
  129. package/dist/cli/args.d.ts +2 -0
  130. package/dist/cli/args.d.ts.map +1 -1
  131. package/dist/cli/args.js +10 -1
  132. package/dist/cli/args.js.map +1 -1
  133. package/dist/cli/baseline.d.ts.map +1 -1
  134. package/dist/cli/baseline.js +5 -1
  135. package/dist/cli/baseline.js.map +1 -1
  136. package/dist/cli/lint.d.ts +9 -1
  137. package/dist/cli/lint.d.ts.map +1 -1
  138. package/dist/cli/lint.js +18 -5
  139. package/dist/cli/lint.js.map +1 -1
  140. package/dist/cli/migrateExceptions.d.ts.map +1 -1
  141. package/dist/cli/migrateExceptions.js +5 -8
  142. package/dist/cli/migrateExceptions.js.map +1 -1
  143. package/dist/cli/misplaced.d.ts +6 -0
  144. package/dist/cli/misplaced.d.ts.map +1 -1
  145. package/dist/cli/misplaced.js +4 -2
  146. package/dist/cli/misplaced.js.map +1 -1
  147. package/dist/cli/program.js +1 -1
  148. package/dist/cli/program.js.map +1 -1
  149. package/dist/cli/runSet.d.ts +5 -0
  150. package/dist/cli/runSet.d.ts.map +1 -0
  151. package/dist/cli/runSet.js +15 -0
  152. package/dist/cli/runSet.js.map +1 -0
  153. package/dist/cli/shrink.d.ts +4 -4
  154. package/dist/cli/shrink.d.ts.map +1 -1
  155. package/dist/cli/shrink.js.map +1 -1
  156. package/dist/cli/usage.d.ts +1 -1
  157. package/dist/cli/usage.d.ts.map +1 -1
  158. package/dist/cli/usage.js +7 -2
  159. package/dist/cli/usage.js.map +1 -1
  160. package/dist/config/decode.d.ts +1 -0
  161. package/dist/config/decode.d.ts.map +1 -1
  162. package/dist/config/decode.js +1 -0
  163. package/dist/config/decode.js.map +1 -1
  164. package/dist/config/load.d.ts +2 -0
  165. package/dist/config/load.d.ts.map +1 -1
  166. package/dist/config/load.js +1 -0
  167. package/dist/config/load.js.map +1 -1
  168. package/dist/config/resolve.d.ts +2 -1
  169. package/dist/config/resolve.d.ts.map +1 -1
  170. package/dist/config/resolve.js +9 -4
  171. package/dist/config/resolve.js.map +1 -1
  172. package/dist/config.d.ts +2 -0
  173. package/dist/config.d.ts.map +1 -1
  174. package/dist/config.js.map +1 -1
  175. package/dist/engine/childStarted.d.ts +4 -0
  176. package/dist/engine/childStarted.d.ts.map +1 -0
  177. package/dist/engine/childStarted.js +7 -0
  178. package/dist/engine/childStarted.js.map +1 -0
  179. package/dist/engine/evaluate.d.ts +1 -0
  180. package/dist/engine/evaluate.d.ts.map +1 -1
  181. package/dist/engine/evaluate.js +2 -1
  182. package/dist/engine/evaluate.js.map +1 -1
  183. package/dist/engine/runRule.d.ts +21 -0
  184. package/dist/engine/runRule.d.ts.map +1 -0
  185. package/dist/engine/runRule.js +70 -0
  186. package/dist/engine/runRule.js.map +1 -0
  187. package/dist/engine/runRules.d.ts +5 -12
  188. package/dist/engine/runRules.d.ts.map +1 -1
  189. package/dist/engine/runRules.js +49 -65
  190. package/dist/engine/runRules.js.map +1 -1
  191. package/dist/engine/session.d.ts +2 -1
  192. package/dist/engine/session.d.ts.map +1 -1
  193. package/dist/engine/session.js +20 -6
  194. package/dist/engine/session.js.map +1 -1
  195. package/dist/engine/violation.d.ts +7 -0
  196. package/dist/engine/violation.d.ts.map +1 -1
  197. package/dist/engine/violation.js +9 -0
  198. package/dist/engine/violation.js.map +1 -1
  199. package/dist/exceptions/MigrationFailure.d.ts +9 -0
  200. package/dist/exceptions/MigrationFailure.d.ts.map +1 -0
  201. package/dist/exceptions/MigrationFailure.js +4 -0
  202. package/dist/exceptions/MigrationFailure.js.map +1 -0
  203. package/dist/exceptions/biomeFindings.d.ts +5 -1
  204. package/dist/exceptions/biomeFindings.d.ts.map +1 -1
  205. package/dist/exceptions/biomeFindings.js +17 -18
  206. package/dist/exceptions/biomeFindings.js.map +1 -1
  207. package/dist/exceptions/migrateBiome.d.ts +3 -1
  208. package/dist/exceptions/migrateBiome.d.ts.map +1 -1
  209. package/dist/exceptions/migrateBiome.js +5 -3
  210. package/dist/exceptions/migrateBiome.js.map +1 -1
  211. package/dist/exceptions/migrateConfig.d.ts +3 -1
  212. package/dist/exceptions/migrateConfig.d.ts.map +1 -1
  213. package/dist/exceptions/migrateConfig.js +40 -25
  214. package/dist/exceptions/migrateConfig.js.map +1 -1
  215. package/dist/exceptions/registry.d.ts.map +1 -1
  216. package/dist/exceptions/registry.js +2 -2
  217. package/dist/exceptions/registry.js.map +1 -1
  218. package/dist/hooks/preCommit.d.ts +1 -2
  219. package/dist/hooks/preCommit.d.ts.map +1 -1
  220. package/dist/hooks/preCommit.js +18 -4
  221. package/dist/hooks/preCommit.js.map +1 -1
  222. package/dist/hooks/stagedCheck.d.ts +5 -0
  223. package/dist/hooks/stagedCheck.d.ts.map +1 -0
  224. package/dist/hooks/stagedCheck.js +43 -0
  225. package/dist/hooks/stagedCheck.js.map +1 -0
  226. package/dist/hooks/withStagedContent.d.ts +5 -0
  227. package/dist/hooks/withStagedContent.d.ts.map +1 -0
  228. package/dist/hooks/withStagedContent.js +84 -0
  229. package/dist/hooks/withStagedContent.js.map +1 -0
  230. package/dist/imports/browserGlobals.d.ts +1 -1
  231. package/dist/imports/browserGlobals.d.ts.map +1 -1
  232. package/dist/imports/browserNames.d.ts +1 -1
  233. package/dist/imports/browserNames.d.ts.map +1 -1
  234. package/dist/imports/browserNames.js +5 -3
  235. package/dist/imports/browserNames.js.map +1 -1
  236. package/dist/imports/departures.d.ts +1 -1
  237. package/dist/imports/departures.d.ts.map +1 -1
  238. package/dist/imports/fences/check.d.ts +1 -1
  239. package/dist/imports/fences/check.d.ts.map +1 -1
  240. package/dist/imports/fences/check.js +1 -1
  241. package/dist/imports/fences/check.js.map +1 -1
  242. package/dist/imports/fences/compilePolicy.d.ts +3 -1
  243. package/dist/imports/fences/compilePolicy.d.ts.map +1 -1
  244. package/dist/imports/fences/compilePolicy.js +5 -3
  245. package/dist/imports/fences/compilePolicy.js.map +1 -1
  246. package/dist/imports/fences/evaluate.d.ts +1 -1
  247. package/dist/imports/fences/evaluate.d.ts.map +1 -1
  248. package/dist/imports/fences/evaluate.js +1 -1
  249. package/dist/imports/fences/evaluate.js.map +1 -1
  250. package/dist/imports/globMatcher.d.ts.map +1 -1
  251. package/dist/imports/globMatcher.js +33 -31
  252. package/dist/imports/globMatcher.js.map +1 -1
  253. package/dist/imports/graph.d.ts +6 -1
  254. package/dist/imports/graph.d.ts.map +1 -1
  255. package/dist/imports/graph.js +30 -2
  256. package/dist/imports/graph.js.map +1 -1
  257. package/dist/imports/pnpmWorkspacePatterns.d.ts +12 -2
  258. package/dist/imports/pnpmWorkspacePatterns.d.ts.map +1 -1
  259. package/dist/imports/pnpmWorkspacePatterns.js +31 -32
  260. package/dist/imports/pnpmWorkspacePatterns.js.map +1 -1
  261. package/dist/imports/withoutGenerated.js +1 -1
  262. package/dist/imports/withoutGenerated.js.map +1 -1
  263. package/dist/imports/workspace.d.ts +1 -1
  264. package/dist/imports/workspace.d.ts.map +1 -1
  265. package/dist/imports/workspace.js +1 -1
  266. package/dist/imports/workspace.js.map +1 -1
  267. package/dist/inventory/programmaticBuilds.d.ts +1 -1
  268. package/dist/inventory/programmaticBuilds.d.ts.map +1 -1
  269. package/dist/inventory/trackedPaths.d.ts +1 -0
  270. package/dist/inventory/trackedPaths.d.ts.map +1 -1
  271. package/dist/inventory/trackedPaths.js +9 -3
  272. package/dist/inventory/trackedPaths.js.map +1 -1
  273. package/dist/manifests/deliveredDependencies.d.ts +3 -0
  274. package/dist/manifests/deliveredDependencies.d.ts.map +1 -0
  275. package/dist/manifests/deliveredDependencies.js +8 -0
  276. package/dist/manifests/deliveredDependencies.js.map +1 -0
  277. package/dist/naming/developmentCode.d.ts +1 -1
  278. package/dist/naming/developmentCode.d.ts.map +1 -1
  279. package/dist/naming/packageTests.d.ts +1 -1
  280. package/dist/naming/packageTests.d.ts.map +1 -1
  281. package/dist/naming/testCode.d.ts +1 -1
  282. package/dist/naming/testCode.d.ts.map +1 -1
  283. package/dist/report/recap.d.ts +4 -0
  284. package/dist/report/recap.d.ts.map +1 -0
  285. package/dist/report/recap.js +23 -0
  286. package/dist/report/recap.js.map +1 -0
  287. package/dist/report/render.d.ts +2 -0
  288. package/dist/report/render.d.ts.map +1 -1
  289. package/dist/report/render.js +11 -4
  290. package/dist/report/render.js.map +1 -1
  291. package/dist/report/runSetLine.d.ts +3 -0
  292. package/dist/report/runSetLine.d.ts.map +1 -0
  293. package/dist/report/runSetLine.js +13 -0
  294. package/dist/report/runSetLine.js.map +1 -0
  295. package/dist/report/staleSections.d.ts.map +1 -1
  296. package/dist/report/staleSections.js +13 -0
  297. package/dist/report/staleSections.js.map +1 -1
  298. package/dist/rule.d.ts +30 -4
  299. package/dist/rule.d.ts.map +1 -1
  300. package/dist/rule.js +4 -2
  301. package/dist/rule.js.map +1 -1
  302. package/dist/rules/biome.d.ts +18 -1
  303. package/dist/rules/biome.d.ts.map +1 -1
  304. package/dist/rules/biome.js +32 -7
  305. package/dist/rules/biome.js.map +1 -1
  306. package/dist/rules/builtIn.d.ts +8 -8
  307. package/dist/rules/builtIn.d.ts.map +1 -1
  308. package/dist/rules/builtIn.js +0 -2
  309. package/dist/rules/builtIn.js.map +1 -1
  310. package/dist/rules/effect/adapterImports.d.ts +1 -1
  311. package/dist/rules/effect/adapterImports.d.ts.map +1 -1
  312. package/dist/rules/effect/adapterImports.js +1 -1
  313. package/dist/rules/effect/adapterImports.js.map +1 -1
  314. package/dist/rules/effect/boundary.d.ts +1 -1
  315. package/dist/rules/effect/boundary.d.ts.map +1 -1
  316. package/dist/rules/effect/boundary.js +60 -75
  317. package/dist/rules/effect/boundary.js.map +1 -1
  318. package/dist/rules/effect/boundaryFindings.d.ts +4 -0
  319. package/dist/rules/effect/boundaryFindings.d.ts.map +1 -0
  320. package/dist/rules/effect/boundaryFindings.js +63 -0
  321. package/dist/rules/effect/boundaryFindings.js.map +1 -0
  322. package/dist/rules/effect/boundaryReference.d.ts +4 -0
  323. package/dist/rules/effect/boundaryReference.d.ts.map +1 -1
  324. package/dist/rules/effect/boundaryReference.js +6 -3
  325. package/dist/rules/effect/boundaryReference.js.map +1 -1
  326. package/dist/rules/effect/contextCapture.d.ts.map +1 -1
  327. package/dist/rules/effect/contextCapture.js +3 -2
  328. package/dist/rules/effect/contextCapture.js.map +1 -1
  329. package/dist/rules/effect/errorTags.d.ts +10 -0
  330. package/dist/rules/effect/errorTags.d.ts.map +1 -0
  331. package/dist/rules/effect/errorTags.js +57 -0
  332. package/dist/rules/effect/errorTags.js.map +1 -0
  333. package/dist/rules/effect/failureHonesty.d.ts +1 -1
  334. package/dist/rules/effect/failureHonesty.d.ts.map +1 -1
  335. package/dist/rules/effect/failureHonesty.js +6 -5
  336. package/dist/rules/effect/failureHonesty.js.map +1 -1
  337. package/dist/rules/effect/policy.d.ts +1 -1
  338. package/dist/rules/effect/policy.d.ts.map +1 -1
  339. package/dist/rules/effect/policy.js +0 -2
  340. package/dist/rules/effect/policy.js.map +1 -1
  341. package/dist/rules/effect/promiseBridge.d.ts +3 -0
  342. package/dist/rules/effect/promiseBridge.d.ts.map +1 -0
  343. package/dist/rules/effect/promiseBridge.js +60 -0
  344. package/dist/rules/effect/promiseBridge.js.map +1 -0
  345. package/dist/rules/effect/rpcBoundary.d.ts.map +1 -1
  346. package/dist/rules/effect/rpcBoundary.js +92 -3
  347. package/dist/rules/effect/rpcBoundary.js.map +1 -1
  348. package/dist/rules/effect/serviceModel.d.ts.map +1 -1
  349. package/dist/rules/effect/serviceModel.js +3 -2
  350. package/dist/rules/effect/serviceModel.js.map +1 -1
  351. package/dist/rules/effect/serviceParameterCheck.d.ts +7 -0
  352. package/dist/rules/effect/serviceParameterCheck.d.ts.map +1 -0
  353. package/dist/rules/effect/serviceParameterCheck.js +15 -0
  354. package/dist/rules/effect/serviceParameterCheck.js.map +1 -0
  355. package/dist/rules/effect/serviceParameters.d.ts.map +1 -1
  356. package/dist/rules/effect/serviceParameters.js +4 -36
  357. package/dist/rules/effect/serviceParameters.js.map +1 -1
  358. package/dist/rules/effect/sharedErrorClasses.d.ts.map +1 -1
  359. package/dist/rules/effect/sharedErrorClasses.js +31 -2
  360. package/dist/rules/effect/sharedErrorClasses.js.map +1 -1
  361. package/dist/rules/effect/workspaceProgram.d.ts +5 -0
  362. package/dist/rules/effect/workspaceProgram.d.ts.map +1 -0
  363. package/dist/rules/effect/workspaceProgram.js +32 -0
  364. package/dist/rules/effect/workspaceProgram.js.map +1 -0
  365. package/dist/rules/imports/adminPaths.d.ts +1 -1
  366. package/dist/rules/imports/adminPaths.d.ts.map +1 -1
  367. package/dist/rules/imports/cycles.d.ts +1 -1
  368. package/dist/rules/imports/cycles.d.ts.map +1 -1
  369. package/dist/rules/imports/fences.d.ts +1 -1
  370. package/dist/rules/imports/fences.d.ts.map +1 -1
  371. package/dist/rules/imports/manifest.d.ts +1 -1
  372. package/dist/rules/imports/manifest.d.ts.map +1 -1
  373. package/dist/rules/imports/noTestCode.d.ts +1 -1
  374. package/dist/rules/imports/noTestCode.d.ts.map +1 -1
  375. package/dist/rules/imports/runtime.d.ts +1 -1
  376. package/dist/rules/imports/runtime.d.ts.map +1 -1
  377. package/dist/rules/imports/runtime.js +32 -5
  378. package/dist/rules/imports/runtime.js.map +1 -1
  379. package/dist/rules/manifestsApplication.d.ts.map +1 -1
  380. package/dist/rules/manifestsApplication.js +4 -5
  381. package/dist/rules/manifestsApplication.js.map +1 -1
  382. package/dist/rules/manifestsNoTestKits.js +1 -1
  383. package/dist/rules/manifestsNoTestKits.js.map +1 -1
  384. package/dist/rules/maxLines.d.ts +1 -1
  385. package/dist/rules/maxLines.d.ts.map +1 -1
  386. package/dist/rules/packageFindings.d.ts +31 -0
  387. package/dist/rules/packageFindings.d.ts.map +1 -0
  388. package/dist/rules/packageFindings.js +65 -0
  389. package/dist/rules/packageFindings.js.map +1 -0
  390. package/dist/rules/parse.d.ts +4 -1
  391. package/dist/rules/parse.d.ts.map +1 -1
  392. package/dist/rules/parse.js +35 -2
  393. package/dist/rules/parse.js.map +1 -1
  394. package/dist/rules/rootedFindings.d.ts +5 -0
  395. package/dist/rules/rootedFindings.d.ts.map +1 -0
  396. package/dist/rules/rootedFindings.js +16 -0
  397. package/dist/rules/rootedFindings.js.map +1 -0
  398. package/dist/rules/stories/adapterOnlyFakes.d.ts +1 -1
  399. package/dist/rules/stories/adapterOnlyFakes.d.ts.map +1 -1
  400. package/dist/rules/stories/adapterOnlyFakes.js +1 -0
  401. package/dist/rules/stories/adapterOnlyFakes.js.map +1 -1
  402. package/dist/rules/stories/databaseUrl.d.ts +1 -1
  403. package/dist/rules/stories/databaseUrl.d.ts.map +1 -1
  404. package/dist/rules/stories/databaseUrl.js +1 -0
  405. package/dist/rules/stories/databaseUrl.js.map +1 -1
  406. package/dist/rules/stories/domainOutcomes.d.ts +1 -1
  407. package/dist/rules/stories/domainOutcomes.d.ts.map +1 -1
  408. package/dist/rules/stories/domainOutcomes.js +1 -0
  409. package/dist/rules/stories/domainOutcomes.js.map +1 -1
  410. package/dist/rules/stories/engine.d.ts +1 -1
  411. package/dist/rules/stories/engine.d.ts.map +1 -1
  412. package/dist/rules/stories/engine.js +1 -0
  413. package/dist/rules/stories/engine.js.map +1 -1
  414. package/dist/rules/stories/globalRetries.d.ts +1 -1
  415. package/dist/rules/stories/globalRetries.d.ts.map +1 -1
  416. package/dist/rules/stories/globalRetries.js +1 -0
  417. package/dist/rules/stories/globalRetries.js.map +1 -1
  418. package/dist/rules/stories/groupedOutcomes.d.ts +1 -1
  419. package/dist/rules/stories/groupedOutcomes.d.ts.map +1 -1
  420. package/dist/rules/stories/groupedOutcomes.js +1 -0
  421. package/dist/rules/stories/groupedOutcomes.js.map +1 -1
  422. package/dist/rules/stories/importedChangeKeys.js +2 -2
  423. package/dist/rules/stories/importedChangeKeys.js.map +1 -1
  424. package/dist/rules/stories/namedValues.d.ts +1 -1
  425. package/dist/rules/stories/namedValues.d.ts.map +1 -1
  426. package/dist/rules/stories/namedValues.js +1 -0
  427. package/dist/rules/stories/namedValues.js.map +1 -1
  428. package/dist/rules/stories/noExpect.d.ts +1 -1
  429. package/dist/rules/stories/noExpect.d.ts.map +1 -1
  430. package/dist/rules/stories/noLimitImports.d.ts +1 -1
  431. package/dist/rules/stories/noLimitImports.d.ts.map +1 -1
  432. package/dist/rules/stories/noLimitImports.js +1 -0
  433. package/dist/rules/stories/noLimitImports.js.map +1 -1
  434. package/dist/rules/stories/positiveRefusals.d.ts +1 -1
  435. package/dist/rules/stories/positiveRefusals.d.ts.map +1 -1
  436. package/dist/rules/stories/positiveRefusals.js +1 -0
  437. package/dist/rules/stories/positiveRefusals.js.map +1 -1
  438. package/dist/rules/stories/queueReadouts.d.ts +1 -1
  439. package/dist/rules/stories/queueReadouts.d.ts.map +1 -1
  440. package/dist/rules/stories/queueReadouts.js +1 -0
  441. package/dist/rules/stories/queueReadouts.js.map +1 -1
  442. package/dist/rules/stories/sources.d.ts +2 -2
  443. package/dist/rules/stories/sources.d.ts.map +1 -1
  444. package/dist/rules/stories/specHelpers.d.ts +1 -1
  445. package/dist/rules/stories/specHelpers.d.ts.map +1 -1
  446. package/dist/rules/stories/specHelpers.js +3 -2
  447. package/dist/rules/stories/specHelpers.js.map +1 -1
  448. package/dist/rules/stories/specs.d.ts +1 -1
  449. package/dist/rules/stories/specs.d.ts.map +1 -1
  450. package/dist/rules/stories/specs.js +1 -0
  451. package/dist/rules/stories/specs.js.map +1 -1
  452. package/dist/rules/stories/waitOnEvents.d.ts +1 -1
  453. package/dist/rules/stories/waitOnEvents.d.ts.map +1 -1
  454. package/dist/rules/stories/waitOnEvents.js +3 -3
  455. package/dist/rules/stories/waitOnEvents.js.map +1 -1
  456. package/dist/rules/suppressions/noDoubleCast.d.ts.map +1 -1
  457. package/dist/rules/suppressions/noDoubleCast.js +4 -49
  458. package/dist/rules/suppressions/noDoubleCast.js.map +1 -1
  459. package/dist/rules/suppressions/typedCastCheck.d.ts +10 -0
  460. package/dist/rules/suppressions/typedCastCheck.d.ts.map +1 -0
  461. package/dist/rules/suppressions/typedCastCheck.js +48 -0
  462. package/dist/rules/suppressions/typedCastCheck.js.map +1 -0
  463. package/dist/rules/unusedCode.d.ts.map +1 -1
  464. package/dist/rules/unusedCode.js +1 -0
  465. package/dist/rules/unusedCode.js.map +1 -1
  466. package/dist/testing/adapters/cli.d.ts +1 -0
  467. package/dist/testing/adapters/cli.d.ts.map +1 -1
  468. package/dist/testing/adapters/cli.js +10 -8
  469. package/dist/testing/adapters/cli.js.map +1 -1
  470. package/dist/testing/adapters/git.d.ts +1 -16
  471. package/dist/testing/adapters/git.d.ts.map +1 -1
  472. package/dist/testing/adapters/git.js +5 -10
  473. package/dist/testing/adapters/git.js.map +1 -1
  474. package/dist/testing/adapters/hookRepository.d.ts +3 -2
  475. package/dist/testing/adapters/hookRepository.d.ts.map +1 -1
  476. package/dist/testing/adapters/hookRepository.js +11 -8
  477. package/dist/testing/adapters/hookRepository.js.map +1 -1
  478. package/dist/testing/adapters/imports.d.ts.map +1 -1
  479. package/dist/testing/adapters/imports.js +4 -1
  480. package/dist/testing/adapters/imports.js.map +1 -1
  481. package/dist/testing/ruleStory.d.ts +1 -1
  482. package/dist/testing/ruleStory.js +2 -2
  483. package/dist/testing/ruleStory.js.map +1 -1
  484. package/docs/debt-and-hooks.md +8 -4
  485. package/package.json +19 -19
  486. package/src/adapters/biome/pluginContract.ts +2 -5
  487. package/src/adapters/biome/run.ts +2 -0
  488. package/src/adapters/biome/withExceptionConfig.ts +26 -5
  489. package/src/adapters/{changeKeyFindings.ts → changeKeyCheck.ts} +8 -24
  490. package/src/adapters/contextCaptureCheck.ts +106 -0
  491. package/src/adapters/declaration-files/initialize.ts +4 -0
  492. package/src/adapters/declaration-files/parse.ts +9 -0
  493. package/src/adapters/declaration-files/reader.ts +28 -0
  494. package/src/adapters/declaration-files/service.ts +16 -0
  495. package/src/adapters/foreignResources.ts +0 -4
  496. package/src/adapters/import-compiler/graph.ts +7 -2
  497. package/src/adapters/imports/graph.ts +43 -18
  498. package/src/adapters/knip/configuration.ts +11 -5
  499. package/src/adapters/knip/run.ts +4 -1
  500. package/src/adapters/outsideImportFindings.ts +22 -65
  501. package/src/adapters/rule.ts +29 -6
  502. package/src/adapters/runMain.ts +7 -6
  503. package/src/adapters/{serviceModelFindings.ts → serviceModelCheck.ts} +10 -25
  504. package/src/adapters/sharedErrorCatalog.ts +43 -0
  505. package/src/adapters/sharedErrorModules.ts +1 -1
  506. package/src/adapters/specReaderSources.ts +6 -3
  507. package/src/adapters/storyProgram.ts +20 -3
  508. package/src/adapters/typeScriptProgram.ts +57 -0
  509. package/src/baseline/compare.ts +59 -19
  510. package/src/baseline/format.ts +7 -2
  511. package/src/baseline/merge.ts +15 -1
  512. package/src/baseline/rewrite.ts +3 -1
  513. package/src/baseline/update.ts +38 -8
  514. package/src/biome/exceptionConfig.ts +24 -3
  515. package/src/biome/scannerRules.ts +42 -0
  516. package/src/cli/args.ts +13 -2
  517. package/src/cli/baseline.ts +7 -1
  518. package/src/cli/lint.ts +34 -18
  519. package/src/cli/migrateExceptions.ts +8 -9
  520. package/src/cli/misplaced.ts +4 -2
  521. package/src/cli/program.ts +1 -1
  522. package/src/cli/runSet.ts +17 -0
  523. package/src/cli/shrink.ts +4 -11
  524. package/src/cli/usage.ts +7 -2
  525. package/src/config/decode.ts +1 -0
  526. package/src/config/load.ts +3 -0
  527. package/src/config/resolve.ts +11 -6
  528. package/src/config.ts +3 -0
  529. package/src/engine/childStarted.ts +8 -0
  530. package/src/engine/evaluate.ts +3 -1
  531. package/src/engine/runRule.ts +103 -0
  532. package/src/engine/runRules.ts +64 -86
  533. package/src/engine/session.ts +23 -5
  534. package/src/engine/violation.ts +16 -0
  535. package/src/exceptions/MigrationFailure.ts +5 -0
  536. package/src/exceptions/biomeFindings.ts +24 -21
  537. package/src/exceptions/migrateBiome.ts +10 -4
  538. package/src/exceptions/migrateConfig.ts +66 -29
  539. package/src/exceptions/registry.ts +2 -2
  540. package/src/hooks/preCommit.ts +22 -7
  541. package/src/hooks/stagedCheck.ts +54 -0
  542. package/src/hooks/withStagedContent.ts +111 -0
  543. package/src/imports/browserNames.ts +7 -5
  544. package/src/imports/fences/check.ts +1 -1
  545. package/src/imports/fences/compilePolicy.ts +6 -4
  546. package/src/imports/fences/evaluate.ts +2 -2
  547. package/src/imports/globMatcher.ts +42 -35
  548. package/src/imports/graph.ts +47 -3
  549. package/src/imports/pnpmWorkspacePatterns.ts +44 -39
  550. package/src/imports/withoutGenerated.ts +1 -1
  551. package/src/imports/workspace.ts +1 -1
  552. package/src/inventory/trackedPaths.ts +10 -3
  553. package/src/manifests/deliveredDependencies.ts +11 -0
  554. package/src/report/recap.ts +29 -0
  555. package/src/report/render.ts +13 -4
  556. package/src/report/runSetLine.ts +14 -0
  557. package/src/report/staleSections.ts +14 -0
  558. package/src/rule.ts +38 -7
  559. package/src/rules/biome.ts +53 -7
  560. package/src/rules/builtIn.ts +0 -2
  561. package/src/rules/effect/adapterImports.ts +1 -1
  562. package/src/rules/effect/boundary.ts +82 -83
  563. package/src/rules/effect/boundaryFindings.ts +71 -0
  564. package/src/rules/effect/boundaryReference.ts +7 -3
  565. package/src/rules/effect/contextCapture.ts +3 -2
  566. package/src/rules/effect/errorTags.ts +72 -0
  567. package/src/rules/effect/failureHonesty.ts +9 -5
  568. package/src/rules/effect/policy.ts +0 -2
  569. package/src/rules/effect/promiseBridge.ts +65 -0
  570. package/src/rules/effect/rpcBoundary.ts +111 -4
  571. package/src/rules/effect/serviceModel.ts +3 -2
  572. package/src/rules/effect/serviceParameterCheck.ts +22 -0
  573. package/src/rules/effect/serviceParameters.ts +5 -37
  574. package/src/rules/effect/sharedErrorClasses.ts +41 -3
  575. package/src/rules/effect/workspaceProgram.ts +34 -0
  576. package/src/rules/imports/runtime.ts +43 -6
  577. package/src/rules/manifestsApplication.ts +4 -5
  578. package/src/rules/manifestsNoTestKits.ts +1 -1
  579. package/src/rules/packageFindings.ts +103 -0
  580. package/src/rules/parse.ts +54 -3
  581. package/src/rules/rootedFindings.ts +19 -0
  582. package/src/rules/stories/adapterOnlyFakes.ts +1 -0
  583. package/src/rules/stories/databaseUrl.ts +1 -0
  584. package/src/rules/stories/domainOutcomes.ts +1 -0
  585. package/src/rules/stories/engine.ts +1 -0
  586. package/src/rules/stories/globalRetries.ts +1 -0
  587. package/src/rules/stories/groupedOutcomes.ts +1 -0
  588. package/src/rules/stories/importedChangeKeys.ts +2 -2
  589. package/src/rules/stories/namedValues.ts +1 -0
  590. package/src/rules/stories/noLimitImports.ts +1 -0
  591. package/src/rules/stories/positiveRefusals.ts +1 -0
  592. package/src/rules/stories/queueReadouts.ts +1 -0
  593. package/src/rules/stories/specHelpers.ts +8 -5
  594. package/src/rules/stories/specs.ts +1 -0
  595. package/src/rules/stories/waitOnEvents.ts +6 -3
  596. package/src/rules/suppressions/noDoubleCast.ts +5 -55
  597. package/src/rules/suppressions/typedCastCheck.ts +55 -0
  598. package/src/rules/unusedCode.ts +1 -0
  599. package/src/testing/adapters/cli.ts +13 -9
  600. package/src/testing/adapters/git.ts +6 -11
  601. package/src/testing/adapters/hookRepository.ts +12 -7
  602. package/src/testing/adapters/imports.ts +4 -1
  603. package/src/testing/ruleStory.ts +2 -2
  604. package/dist/adapters/biome/presetConfig.d.ts +0 -21
  605. package/dist/adapters/biome/presetConfig.d.ts.map +0 -1
  606. package/dist/adapters/biome/presetConfig.js +0 -32
  607. package/dist/adapters/biome/presetConfig.js.map +0 -1
  608. package/dist/adapters/changeKeyFindings.d.ts +0 -4
  609. package/dist/adapters/changeKeyFindings.d.ts.map +0 -1
  610. package/dist/adapters/changeKeyFindings.js.map +0 -1
  611. package/dist/adapters/contextCaptureFindings.d.ts +0 -4
  612. package/dist/adapters/contextCaptureFindings.d.ts.map +0 -1
  613. package/dist/adapters/contextCaptureFindings.js +0 -51
  614. package/dist/adapters/contextCaptureFindings.js.map +0 -1
  615. package/dist/adapters/nativeTransactionFindings.d.ts +0 -4
  616. package/dist/adapters/nativeTransactionFindings.d.ts.map +0 -1
  617. package/dist/adapters/nativeTransactionFindings.js +0 -98
  618. package/dist/adapters/nativeTransactionFindings.js.map +0 -1
  619. package/dist/adapters/rpcBoundaryFindings.d.ts +0 -4
  620. package/dist/adapters/rpcBoundaryFindings.d.ts.map +0 -1
  621. package/dist/adapters/rpcBoundaryFindings.js +0 -90
  622. package/dist/adapters/rpcBoundaryFindings.js.map +0 -1
  623. package/dist/adapters/serviceModelFindings.d.ts +0 -4
  624. package/dist/adapters/serviceModelFindings.d.ts.map +0 -1
  625. package/dist/adapters/serviceModelFindings.js.map +0 -1
  626. package/dist/adapters/sharedErrorFindings.d.ts +0 -4
  627. package/dist/adapters/sharedErrorFindings.d.ts.map +0 -1
  628. package/dist/adapters/sharedErrorFindings.js +0 -71
  629. package/dist/adapters/sharedErrorFindings.js.map +0 -1
  630. package/dist/adapters/transactionChanges.d.ts +0 -3
  631. package/dist/adapters/transactionChanges.d.ts.map +0 -1
  632. package/dist/adapters/transactionChanges.js +0 -81
  633. package/dist/adapters/transactionChanges.js.map +0 -1
  634. package/dist/adapters/vitePort.d.ts +0 -2
  635. package/dist/adapters/vitePort.d.ts.map +0 -1
  636. package/dist/adapters/vitePort.js +0 -5
  637. package/dist/adapters/vitePort.js.map +0 -1
  638. package/dist/appTestConfig.d.ts +0 -4
  639. package/dist/appTestConfig.d.ts.map +0 -1
  640. package/dist/appTestConfig.js +0 -9
  641. package/dist/appTestConfig.js.map +0 -1
  642. package/dist/appViteConfig.d.ts +0 -23
  643. package/dist/appViteConfig.d.ts.map +0 -1
  644. package/dist/appViteConfig.js +0 -17
  645. package/dist/appViteConfig.js.map +0 -1
  646. package/dist/biome/recommendedRules.d.ts +0 -3
  647. package/dist/biome/recommendedRules.d.ts.map +0 -1
  648. package/dist/biome/recommendedRules.js +0 -20
  649. package/dist/biome/recommendedRules.js.map +0 -1
  650. package/dist/rules/effect/program.d.ts +0 -8
  651. package/dist/rules/effect/program.d.ts.map +0 -1
  652. package/dist/rules/effect/program.js +0 -53
  653. package/dist/rules/effect/program.js.map +0 -1
  654. package/dist/rules/effect/sqlTransact.d.ts +0 -2
  655. package/dist/rules/effect/sqlTransact.d.ts.map +0 -1
  656. package/dist/rules/effect/sqlTransact.js +0 -9
  657. package/dist/rules/effect/sqlTransact.js.map +0 -1
  658. package/dist/rules/suppressions/biomeRecommended.d.ts +0 -7
  659. package/dist/rules/suppressions/biomeRecommended.d.ts.map +0 -1
  660. package/dist/rules/suppressions/biomeRecommended.js +0 -47
  661. package/dist/rules/suppressions/biomeRecommended.js.map +0 -1
  662. package/src/adapters/biome/presetConfig.ts +0 -34
  663. package/src/adapters/contextCaptureFindings.ts +0 -60
  664. package/src/adapters/nativeTransactionFindings.ts +0 -108
  665. package/src/adapters/rpcBoundaryFindings.ts +0 -98
  666. package/src/adapters/sharedErrorFindings.ts +0 -84
  667. package/src/adapters/transactionChanges.ts +0 -85
  668. package/src/adapters/vitePort.ts +0 -5
  669. package/src/appTestConfig.ts +0 -10
  670. package/src/appViteConfig.ts +0 -24
  671. package/src/biome/recommendedRules.ts +0 -27
  672. package/src/rules/effect/program.ts +0 -57
  673. package/src/rules/effect/sqlTransact.ts +0 -10
  674. package/src/rules/suppressions/biomeRecommended.ts +0 -60
@@ -1,99 +1,78 @@
1
- import { basename, isAbsolute, relative } from "node:path";
2
- import { Effect } from "effect";
3
- import { ManifestFailure } from "#adapters/manifestInventory.ts";
4
- import { inNonEffectFolder } from "#config/nonEffectFolders.ts";
5
- import type { ActiveLevel, Violation } from "#engine/violation.ts";
6
- import { SetupFailure } from "#failure.ts";
7
- import { FilesystemFailure } from "#inventory/filesystem.ts";
8
- import { posix } from "#inventory/ignoreScope.ts";
9
- import type { Finding, RuleCheck, RuleInputs, RuleServices } from "#rule.ts";
1
+ import { Deferred, Effect, Fiber } from "effect";
2
+ import { withStoryProgram } from "#adapters/storyProgram.ts";
3
+ import { ChildStarted } from "#engine/childStarted.ts";
4
+ import { type ActiveRule, runRule } from "#engine/runRule.ts";
5
+ import type { Violation } from "#engine/violation.ts";
6
+ import type { SetupFailure } from "#failure.ts";
7
+ import type { RuleInputs, RuleServices } from "#rule.ts";
8
+ import { PACKAGE_CHECKS, withPackageWalk } from "#rules/packageFindings.ts";
9
+ import { withSharedTrees } from "#rules/parse.ts";
10
10
 
11
- export interface ActiveRule {
12
- readonly check: RuleCheck;
13
- readonly description: string;
14
- readonly family: boolean;
15
- readonly id: string;
16
- readonly level: ActiveLevel;
17
- readonly registrable?: boolean;
18
- }
11
+ type RuleRun = Effect.Effect<readonly Violation[], SetupFailure, RuleServices>;
19
12
 
20
- function messageOf(cause: unknown): string {
21
- return cause instanceof Error ? cause.message : String(cause);
13
+ function spawnsChild(rule: ActiveRule): boolean {
14
+ return rule.needs === "child-process";
22
15
  }
23
16
 
24
- // Registry and baseline entries match on the path, so every finding names its file the same way.
25
- function repositoryPath(root: string, file: string): string {
26
- return posix(isAbsolute(file) ? relative(root, file) : file).replace(/^(?:\.\/)+/u, "");
27
- }
17
+ const launched = Effect.fn("Engine.launched")(function* (child: RuleRun) {
18
+ const running = yield* Deferred.make<void>();
19
+ const fiber = yield* Effect.forkChild(Effect.provideService(child, ChildStarted, Deferred.succeed(running, undefined).pipe(Effect.asVoid)));
20
+ return { fiber, started: Effect.raceFirst(Deferred.await(running), Fiber.await(fiber)) };
21
+ });
28
22
 
29
- function exceptionHint(rule: ActiveRule, finding: Finding, file: string, config: string): string {
30
- const id = rule.family && finding.subject !== undefined ? `${rule.id}/${finding.subject}` : rule.id;
31
- const biome = /^biome\/(?:lint|assist)\/[a-zA-Z]+\/[a-zA-Z]+$/u.test(id);
32
- if (!biome && rule.registrable === false) {
33
- return "";
34
- }
35
- const shape = JSON.stringify({
36
- files: [file],
37
- reason: "Explain why this exception is permanent.",
38
- rules: [id],
39
- ...(!rule.family && finding.subject !== undefined ? { subject: finding.subject } : {}),
40
- });
41
- return ` For a permanent exception, add to exceptions in ${config}: ${shape}.`;
23
+ function readsStories(rule: ActiveRule): boolean {
24
+ return rule.needs === "story-program";
42
25
  }
43
26
 
44
- function violationOf(rule: ActiveRule, root: string, finding: Finding, exceptionFile: string): Violation {
45
- return {
46
- ...finding,
47
- file: repositoryPath(root, finding.file),
48
- level: rule.level,
49
- message: finding.message + exceptionHint(rule, finding, repositoryPath(root, finding.file), exceptionFile),
50
- rule: rule.family && finding.subject !== undefined ? `${rule.id}/${finding.subject}` : rule.id,
51
- };
27
+ // A full run checks a rule's deep half as a run of its own in the deep tier; only that half reads the package walk.
28
+ function runsOf(rule: ActiveRule, skippedHalves: ReadonlySet<string>): readonly ActiveRule[] {
29
+ const { deepHalf, ...whole } = rule;
30
+ return deepHalf === undefined || skippedHalves.has(rule.id) ? [rule] : [rule, { ...whole, check: deepHalf.check, depth: "deep", half: "deep" }];
52
31
  }
53
32
 
54
- function expectedFailure(rule: ActiveRule, root: string, cause: unknown): readonly Violation[] | undefined {
55
- if (cause instanceof ManifestFailure || cause instanceof FilesystemFailure) {
56
- const manifest = cause instanceof ManifestFailure || basename(cause.path) === "package.json";
57
- return [
58
- {
59
- file: repositoryPath(root, cause.path),
60
- level: rule.level,
61
- message: cause.message,
62
- rule: manifest ? "manifests/valid" : rule.id,
63
- },
64
- ];
65
- }
66
- return undefined;
33
+ function walks(rule: ActiveRule): boolean {
34
+ return PACKAGE_CHECKS.has(rule.id) && rule.deepHalf === undefined;
67
35
  }
68
36
 
69
- function runRule(rule: ActiveRule, inputs: RuleInputs, exceptionFile: string): Effect.Effect<readonly Violation[], SetupFailure, RuleServices> {
70
- return Effect.suspend(() => rule.check(inputs)).pipe(
71
- Effect.map((findings) =>
72
- findings
73
- .filter(
74
- (finding) =>
75
- !(rule.id.startsWith("effect/") && inNonEffectFolder(repositoryPath(inputs.root, finding.file), inputs.nonEffectFolders ?? [])),
76
- )
77
- .map((finding) => violationOf(rule, inputs.root, finding, exceptionFile)),
37
+ // Rules share one Node thread, so only the Biome and Knip child processes run beside the other rules, started first because synchronous rules would starve their preparation; a check that never reports its child as started finishes first. Each type-checker program, the package walk's included, is built alone.
38
+ // The rules that read the story program, which spans every source, run one after another so the run drops it after the last of them; they and the program share one tree per source, which goes with the program because keeping the trees for every rule raised the peak.
39
+ function runTiers(rules: readonly ActiveRule[], inputs: RuleInputs): RuleRun {
40
+ function run(rule: ActiveRule): RuleRun {
41
+ return runRule(rule, inputs, inputs.configFile ?? "quality.config.ts");
42
+ }
43
+ const walked = rules.filter(walks);
44
+ const inThread = rules.filter((rule) => !(walks(rule) || spawnsChild(rule) || readsStories(rule)));
45
+ const stories = rules.filter(readsStories).map(run);
46
+ const told =
47
+ stories.length === 0 ? [] : [Effect.map(withSharedTrees(inputs, withStoryProgram(inputs, Effect.all(stories))), (found) => found.flat())];
48
+ const fast = [...inThread.filter((rule) => rule.depth === "fast").map(run), ...told];
49
+ const deep = inThread.filter((rule) => rule.depth === "deep").map(run);
50
+ function lanes(thread: readonly RuleRun[]): RuleRun {
51
+ return Effect.gen(function* () {
52
+ const children = yield* Effect.forEach(rules.filter(spawnsChild).map(run), launched);
53
+ yield* Effect.forEach(children, ({ started }) => started, { concurrency: "unbounded" });
54
+ const inOrder = yield* Effect.all(thread);
55
+ return [...(yield* Effect.forEach(children, ({ fiber }) => Fiber.join(fiber))).flat(), ...inOrder.flat()];
56
+ });
57
+ }
58
+ if (walked.length === 0) {
59
+ return lanes([...fast, ...deep]);
60
+ }
61
+ return withPackageWalk(inputs, new Set(walked.map((rule) => rule.id)), (walk) =>
62
+ Effect.map(
63
+ Effect.all([lanes([Effect.as(walk, []), ...fast, ...deep]), Effect.all(walked.map(run), { concurrency: "unbounded" })], {
64
+ concurrency: "unbounded",
65
+ }),
66
+ ([laned, waited]) => [...laned, ...waited.flat()],
78
67
  ),
79
- Effect.catch((cause) => {
80
- const findings = expectedFailure(rule, inputs.root, cause);
81
- if (findings !== undefined) {
82
- return Effect.succeed(findings);
83
- }
84
- if (cause instanceof SetupFailure) {
85
- return Effect.fail(new SetupFailure({ cause, message: `rule ${rule.id} failed: ${cause.message}` }));
86
- }
87
- return Effect.die(cause);
88
- }),
89
- Effect.catchDefect((cause) => {
90
- const findings = expectedFailure(rule, inputs.root, cause);
91
- return findings === undefined ? Effect.die(new Error(`rule ${rule.id} failed: ${messageOf(cause)}`, { cause })) : Effect.succeed(findings);
92
- }),
93
68
  );
94
69
  }
95
70
 
96
- export const runRules = Effect.fn("Engine.runRules")(function* (rules: readonly ActiveRule[], inputs: RuleInputs) {
71
+ export const runRules = Effect.fn("Engine.runRules")(function* (
72
+ rules: readonly ActiveRule[],
73
+ inputs: RuleInputs,
74
+ skippedHalves: ReadonlySet<string> = new Set(),
75
+ ) {
97
76
  const validation = rules.find((rule) => rule.id === "manifests/valid");
98
77
  if (validation !== undefined) {
99
78
  const failures = yield* runRule(validation, inputs, inputs.configFile ?? "quality.config.ts");
@@ -101,13 +80,12 @@ export const runRules = Effect.fn("Engine.runRules")(function* (rules: readonly
101
80
  return failures;
102
81
  }
103
82
  }
104
- const results = yield* Effect.forEach(
105
- rules.filter((rule) => rule !== validation),
106
- (rule) => runRule(rule, inputs, inputs.configFile ?? "quality.config.ts"),
107
- { concurrency: 2 },
83
+ const results = yield* runTiers(
84
+ rules.filter((rule) => rule !== validation).flatMap((rule) => runsOf(rule, skippedHalves)),
85
+ inputs,
108
86
  );
109
87
  const seen = new Set<string>();
110
- return results.flat().filter((finding) => {
88
+ return results.filter((finding) => {
111
89
  if (finding.rule !== "manifests/valid") {
112
90
  return true;
113
91
  }
@@ -2,11 +2,12 @@ import * as NodePath from "@effect/platform-node/NodePath";
2
2
  import { Effect, Path } from "effect";
3
3
  import { setManifestFiles } from "#adapters/manifestInventory.ts";
4
4
  import { manifestReader } from "#adapters/manifestReader.ts";
5
+ import { typeScriptProgram } from "#adapters/typeScriptProgram.ts";
5
6
  import { loadConfig, type ResolvedConfig } from "#config/load.ts";
6
7
  import { type BaselineFile, readBaseline, readInput } from "#engine/baselineFile.ts";
7
8
  import { runRules } from "#engine/runRules.ts";
8
9
  import type { Violation } from "#engine/violation.ts";
9
- import { staleBiomeExceptions } from "#exceptions/biomeFindings.ts";
10
+ import { biomeExceptions } from "#exceptions/biomeFindings.ts";
10
11
  import type { RegistryEntry, StaleRegistryEntry } from "#exceptions/registry.ts";
11
12
  import { registryEntries } from "#exceptions/registryEntries.ts";
12
13
  import { SetupFailure } from "#failure.ts";
@@ -45,17 +46,34 @@ export const scan = Effect.fn("Engine.scan")(function* (
45
46
  readText,
46
47
  root: config.root,
47
48
  sources: inventory.sources,
49
+ typeScript: yield* typeScriptProgram(config.root, inventory.sources),
48
50
  };
49
- const violations = yield* runRules(config.active, inputs);
50
- const staleRegistry = yield* setup(staleBiomeExceptions(inputs));
51
- return { inventory, staleRegistry, violations };
51
+ const { kept, stale } = yield* setup(biomeExceptions(yield* runRules(config.active, inputs, config.skippedHalves), inputs, config.skippedHalves));
52
+ return { inventory, staleRegistry: stale, violations: kept };
52
53
  });
53
54
 
55
+ export type RunSet = "fast" | "full";
56
+
57
+ // A fast run leaves deep rules and deep halves out and sets aside the baseline entries and exceptions it cannot judge.
58
+ function selected(config: ResolvedConfig, set: RunSet): ResolvedConfig {
59
+ if (set === "full") {
60
+ return config;
61
+ }
62
+ const active = config.active.filter((rule) => rule.depth === "fast");
63
+ return {
64
+ ...config,
65
+ active,
66
+ skipped: new Set(config.active.filter((rule) => rule.depth === "deep").map((rule) => rule.id)),
67
+ skippedHalves: new Set(active.filter((rule) => rule.deepHalf !== undefined).map((rule) => rule.id)),
68
+ };
69
+ }
70
+
54
71
  export const openSession = Effect.fn("Engine.openSession")(function* (
55
72
  cwd: string,
56
73
  configPath: string | undefined,
74
+ set: RunSet = "full",
57
75
  ): Effect.fn.Return<Session, SetupFailure, RuleServices> {
58
- const config = yield* loadConfig(cwd, configPath);
76
+ const config = selected(yield* loadConfig(cwd, configPath), set);
59
77
  const selection = configPath === undefined ? "" : ` --config ${configPath}`;
60
78
  for (const path of new Set([config.registry, "quality/registry.json"])) {
61
79
  if ((yield* readInput(config.root, path)) !== undefined) {
@@ -4,6 +4,7 @@ import type { Finding } from "#rule.ts";
4
4
  export type ActiveLevel = "error";
5
5
 
6
6
  export interface Violation extends Finding {
7
+ readonly deep?: true;
7
8
  readonly level: ActiveLevel;
8
9
  readonly rule: string;
9
10
  }
@@ -32,6 +33,9 @@ export function groupBy<TItem>(items: readonly TItem[], key: (item: TItem) => st
32
33
  export interface RuleIndex {
33
34
  readonly families: ReadonlySet<string>;
34
35
  readonly levels: ReadonlyMap<string, Level>;
36
+ readonly skipped: ReadonlySet<string>;
37
+ readonly skippedHalves: ReadonlySet<string>;
38
+ readonly split: ReadonlySet<string>;
35
39
  readonly unregistrable: ReadonlySet<string>;
36
40
  }
37
41
 
@@ -47,6 +51,18 @@ export function levelOf(index: RuleIndex, rule: string): Level | undefined {
47
51
  return index.levels.get(ownerOf(index, rule));
48
52
  }
49
53
 
54
+ export function skipped(index: RuleIndex, rule: string): boolean {
55
+ return index.skipped.has(ownerOf(index, rule));
56
+ }
57
+
58
+ export function halfSkipped(index: RuleIndex, rule: string): boolean {
59
+ return index.skippedHalves.has(ownerOf(index, rule));
60
+ }
61
+
62
+ export function isSplit(index: RuleIndex, rule: string): boolean {
63
+ return index.split.has(ownerOf(index, rule));
64
+ }
65
+
50
66
  export function registrable(index: RuleIndex, rule: string): boolean {
51
67
  return !index.unregistrable.has(ownerOf(index, rule));
52
68
  }
@@ -0,0 +1,5 @@
1
+ import { Data } from "effect";
2
+
3
+ export class MigrationFailure extends Data.TaggedError("MigrationFailure")<{
4
+ readonly message: string;
5
+ }> {}
@@ -1,33 +1,36 @@
1
1
  import { Effect } from "effect";
2
- import { biomeReport } from "#biome/report.ts";
3
- import { withoutEntryPointImports } from "#biome/withoutEntryPointImports.ts";
2
+ import { needsScanner } from "#biome/scannerRules.ts";
3
+ import { keyOf, type Violation } from "#engine/violation.ts";
4
4
  import type { StaleRegistryEntry } from "#exceptions/registry.ts";
5
5
  import type { FilesystemFailure } from "#inventory/filesystem.ts";
6
6
  import type { Finding, RuleInputs } from "#rule.ts";
7
7
 
8
- export const staleBiomeExceptions = Effect.fn("Exceptions.staleBiomeExceptions")(function* (inputs: RuleInputs) {
9
- const declarations = inputs.exceptions ?? [];
10
- const declared = declarations.flatMap(({ files, reason, rules }) =>
8
+ // The biome rule reports excepted diagnostics at any severity; the session drops them and names each exception that none matched.
9
+ export const biomeExceptions = Effect.fn("Exceptions.biomeExceptions")(function* (
10
+ violations: readonly Violation[],
11
+ inputs: Pick<RuleInputs, "configFile" | "exceptions" | "readText">,
12
+ skippedHalves: ReadonlySet<string>,
13
+ ) {
14
+ const declared = (inputs.exceptions ?? []).flatMap(({ files, reason, rules }) =>
11
15
  rules.filter((rule) => /^biome\/(?:lint|assist)\//u.test(rule)).flatMap((rule) => files.map((file) => ({ file, reason, rule }))),
12
16
  );
17
+ const excepted = new Set(declared.map(({ file, rule }) => keyOf(rule, file)));
18
+ const reported = new Set(violations.map((violation) => keyOf(violation.rule, violation.file)));
13
19
  const texts = yield* Effect.forEach(declared, ({ file }) => inputs.readText(file), { concurrency: "unbounded" });
14
- const entries = declared.filter((_, index) => texts[index] !== undefined);
15
- if (entries.length === 0) {
16
- return [];
17
- }
18
- const exclusions = declarations.flatMap((entry) =>
19
- entry.rules.includes("biome/files/includes") ? [{ ...entry, rules: ["biome/files/includes"] as const }] : [],
20
+ const judged = declared.filter(
21
+ (entry, index) => texts[index] !== undefined && !(skippedHalves.has("biome") && needsScanner(entry.rule.slice("biome/".length))),
20
22
  );
21
- const report = yield* biomeReport(inputs.root, ["check", "--no-errors-on-unmatched"], exclusions, [...new Set(entries.map(({ file }) => file))]);
22
- const diagnostics = yield* withoutEntryPointImports(inputs, report.diagnostics);
23
- return entries
24
- .filter(({ file, rule }) => !diagnostics.some((diagnostic) => diagnostic.location.path === file && `biome/${diagnostic.category}` === rule))
25
- .map(
26
- (entry): StaleRegistryEntry => ({
27
- entry,
28
- problem: `matches no finding. Remove this file/rule pair from exceptions in ${inputs.configFile ?? "quality.config.ts"}`,
29
- }),
30
- );
23
+ return {
24
+ kept: violations.filter((violation) => !excepted.has(keyOf(violation.rule, violation.file))),
25
+ stale: judged
26
+ .filter(({ file, rule }) => !reported.has(keyOf(rule, file)))
27
+ .map(
28
+ (entry): StaleRegistryEntry => ({
29
+ entry,
30
+ problem: `matches no finding. Remove this file/rule pair from exceptions in ${inputs.configFile ?? "quality.config.ts"}`,
31
+ }),
32
+ ),
33
+ };
31
34
  });
32
35
 
33
36
  const missingBiomeFile = Effect.fn("Exceptions.missingBiomeFile")(function* (
@@ -1,4 +1,6 @@
1
+ import { Result } from "effect";
1
2
  import ts from "typescript";
3
+ import { MigrationFailure } from "#exceptions/MigrationFailure.ts";
2
4
  import type { Declaration } from "#rules/suppressions/biome/declarations.ts";
3
5
 
4
6
  function nameOf(property: ts.ObjectLiteralElementLike): string | undefined {
@@ -34,11 +36,13 @@ function settingPath(rule: string): readonly string[] {
34
36
  return tool === "files" ? ["files", "includes"] : [tool === "lint" ? "linter" : "assist", tool === "lint" ? "rules" : "actions", group, name];
35
37
  }
36
38
 
37
- export function migrateBiome(text: string, file: string, declarations: readonly Declaration[]): string {
39
+ export function migrateBiome(text: string, file: string, declarations: readonly Declaration[]): Result.Result<string, MigrationFailure> {
38
40
  const source = ts.parseJsonText(file, text);
39
41
  const root = source.statements[0]?.expression;
40
42
  if (ts.parseConfigFileTextToJson(file, text).error !== undefined || root === undefined || !ts.isObjectLiteralExpression(root)) {
41
- throw new Error(`Cannot migrate invalid Biome config ${file}. Repair it, then run quality exceptions migrate again.`);
43
+ return Result.fail(
44
+ new MigrationFailure({ message: `Cannot migrate invalid Biome config ${file}. Repair it, then run quality exceptions migrate again.` }),
45
+ );
42
46
  }
43
47
  const globals = declarations.filter((entry) => entry.rule === "files/includes");
44
48
  const stripped = strip(
@@ -46,7 +50,7 @@ export function migrateBiome(text: string, file: string, declarations: readonly
46
50
  globals.map((entry) => settingPath(entry.rule)),
47
51
  );
48
52
  if (!ts.isObjectLiteralExpression(stripped)) {
49
- throw new Error(`Cannot migrate ${file}.`);
53
+ return Result.fail(new MigrationFailure({ message: `Cannot migrate ${file}.` }));
50
54
  }
51
55
  const properties = stripped.properties.flatMap((property) => {
52
56
  if (nameOf(property) !== "overrides" || !ts.isPropertyAssignment(property) || !ts.isArrayLiteralExpression(property.initializer)) {
@@ -74,5 +78,7 @@ export function migrateBiome(text: string, file: string, declarations: readonly
74
78
  ? []
75
79
  : [ts.factory.updatePropertyAssignment(property, property.name, ts.factory.updateArrayLiteralExpression(property.initializer, overrides))];
76
80
  });
77
- return `${ts.createPrinter().printNode(ts.EmitHint.Expression, ts.factory.updateObjectLiteralExpression(root, properties), source)}\n`;
81
+ return Result.succeed(
82
+ `${ts.createPrinter().printNode(ts.EmitHint.Expression, ts.factory.updateObjectLiteralExpression(root, properties), source)}\n`,
83
+ );
78
84
  }
@@ -1,5 +1,12 @@
1
+ import { Result } from "effect";
1
2
  import ts from "typescript";
2
3
  import type { ExceptionDeclaration } from "#exceptions/declaration.ts";
4
+ import { MigrationFailure } from "#exceptions/MigrationFailure.ts";
5
+
6
+ interface KeptProperty {
7
+ readonly name: string;
8
+ readonly text: string;
9
+ }
3
10
 
4
11
  function objectOf(expression: ts.Expression): ts.ObjectLiteralExpression | undefined {
5
12
  if (ts.isObjectLiteralExpression(expression)) {
@@ -13,52 +20,82 @@ function objectOf(expression: ts.Expression): ts.ObjectLiteralExpression | undef
13
20
  : undefined;
14
21
  }
15
22
 
16
- function nameOf(property: ts.ObjectLiteralElementLike): string | undefined {
23
+ function nameOf(property: ts.ObjectLiteralElementLike): Result.Result<string | undefined, MigrationFailure> {
17
24
  const name = property.name;
18
25
  if (name === undefined) {
19
- return undefined;
26
+ return Result.succeed(undefined);
20
27
  }
21
28
  if (ts.isComputedPropertyName(name)) {
22
29
  if (ts.isStringLiteral(name.expression) || ts.isNoSubstitutionTemplateLiteral(name.expression) || ts.isNumericLiteral(name.expression)) {
23
- return name.expression.text;
30
+ return Result.succeed(name.expression.text);
24
31
  }
25
- throw new Error("Cannot migrate a computed property automatically. Use literal property keys, then run quality exceptions migrate again.");
32
+ return Result.fail(
33
+ new MigrationFailure({
34
+ message: "Cannot migrate a computed property automatically. Use literal property keys, then run quality exceptions migrate again.",
35
+ }),
36
+ );
26
37
  }
27
- return ts.isStringLiteral(name) || ts.isIdentifier(name) || ts.isNumericLiteral(name) ? name.text : undefined;
38
+ return Result.succeed(ts.isStringLiteral(name) || ts.isIdentifier(name) || ts.isNumericLiteral(name) ? name.text : undefined);
28
39
  }
29
40
 
30
- export function migrateConfig(text: string | undefined, file: string, exceptions: readonly ExceptionDeclaration[], hasDeclarations: boolean): string {
31
- if (text === undefined) {
32
- return `export default { exceptions: ${JSON.stringify(exceptions, null, "\t")} };\n`;
33
- }
34
- const source = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
35
- const exported = source.statements.find(ts.isExportAssignment);
36
- const object = exported === undefined ? undefined : objectOf(exported.expression);
37
- if (object === undefined || object.properties.some(ts.isSpreadAssignment)) {
38
- throw new Error(
39
- `Cannot migrate ${file} automatically. Export an object or defineConfig({ ... }) without spreads, then run quality exceptions migrate again.`,
40
- );
41
- }
42
- const properties = object.properties.flatMap((property) => {
43
- const name = nameOf(property);
41
+ function keptRules(initializer: ts.ObjectLiteralExpression, source: ts.SourceFile): Result.Result<readonly KeptProperty[], MigrationFailure> {
42
+ return Result.map(
43
+ Result.all(initializer.properties.map((rule) => Result.map(nameOf(rule), (name) => (name === "suppressions/biome-overrides" ? [] : [rule])))),
44
+ (kept) => {
45
+ const rules = kept.flat();
46
+ return rules.length === 0 ? [] : [{ name: "rules", text: `rules: {\n${rules.map((rule) => rule.getFullText(source).trim()).join(",\n")}\n}` }];
47
+ },
48
+ );
49
+ }
50
+
51
+ function keptProperty(
52
+ property: ts.ObjectLiteralElementLike,
53
+ source: ts.SourceFile,
54
+ file: string,
55
+ hasDeclarations: boolean,
56
+ ): Result.Result<readonly KeptProperty[], MigrationFailure> {
57
+ return Result.flatMap(nameOf(property), (name): Result.Result<readonly KeptProperty[], MigrationFailure> => {
44
58
  if (name === "registry" || name === "exceptions") {
45
- return [];
59
+ return Result.succeed([]);
46
60
  }
47
61
  if (name !== "rules" || !hasDeclarations) {
48
- return [{ name: name ?? "", text: property.getFullText(source).trim() }];
62
+ return Result.succeed([{ name: name ?? "", text: property.getFullText(source).trim() }]);
49
63
  }
50
64
  if (
51
65
  !(ts.isPropertyAssignment(property) && ts.isObjectLiteralExpression(property.initializer))
52
66
  || property.initializer.properties.some(ts.isSpreadAssignment)
53
67
  ) {
54
- throw new Error(`Inline the rules object in ${file}, then run quality exceptions migrate again.`);
68
+ return Result.fail(new MigrationFailure({ message: `Inline the rules object in ${file}, then run quality exceptions migrate again.` }));
55
69
  }
56
- const rules = property.initializer.properties.filter((rule) => nameOf(rule) !== "suppressions/biome-overrides");
57
- return rules.length === 0 ? [] : [{ name: "rules", text: `rules: {\n${rules.map((rule) => rule.getFullText(source).trim()).join(",\n")}\n}` }];
70
+ return keptRules(property.initializer, source);
71
+ });
72
+ }
73
+
74
+ export function migrateConfig(
75
+ text: string | undefined,
76
+ file: string,
77
+ exceptions: readonly ExceptionDeclaration[],
78
+ hasDeclarations: boolean,
79
+ ): Result.Result<string, MigrationFailure> {
80
+ if (text === undefined) {
81
+ return Result.succeed(`export default { exceptions: ${JSON.stringify(exceptions, null, "\t")} };\n`);
82
+ }
83
+ const source = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
84
+ const exported = source.statements.find(ts.isExportAssignment);
85
+ const object = exported === undefined ? undefined : objectOf(exported.expression);
86
+ if (object === undefined || object.properties.some(ts.isSpreadAssignment)) {
87
+ return Result.fail(
88
+ new MigrationFailure({
89
+ message: `Cannot migrate ${file} automatically. Export an object or defineConfig({ ... }) without spreads, then run quality exceptions migrate again.`,
90
+ }),
91
+ );
92
+ }
93
+ return Result.map(Result.all(object.properties.map((property) => keptProperty(property, source, file, hasDeclarations))), (kept) => {
94
+ const properties = kept.flat();
95
+ const next = properties.map((property) => property.text);
96
+ const index = properties.findIndex((property) => property.name > "exceptions");
97
+ next.splice(index < 0 ? next.length : index, 0, `exceptions: ${JSON.stringify(exceptions, null, "\t")}`);
98
+ const replacement = `{\n${next.join(",\n")}\n}`;
99
+ return text.slice(0, object.getStart(source)) + replacement + text.slice(object.end);
58
100
  });
59
- const next = properties.map((property) => property.text);
60
- const index = properties.findIndex((property) => property.name > "exceptions");
61
- next.splice(index < 0 ? next.length : index, 0, `exceptions: ${JSON.stringify(exceptions, null, "\t")}`);
62
- const replacement = `{\n${next.join(",\n")}\n}`;
63
- return text.slice(0, object.getStart(source)) + replacement + text.slice(object.end);
64
101
  }
@@ -1,6 +1,6 @@
1
1
  import { Schema } from "effect";
2
2
  import { type Decoded, decodeWith } from "#decoded.ts";
3
- import { type RuleIndex, registrable, unusedEntryProblem, type Violation } from "#engine/violation.ts";
3
+ import { halfSkipped, type RuleIndex, registrable, skipped, unusedEntryProblem, type Violation } from "#engine/violation.ts";
4
4
 
5
5
  const RegistryEntry = Schema.Struct({
6
6
  file: Schema.NonEmptyString,
@@ -50,7 +50,7 @@ export function applyRegistry(violations: readonly Violation[], entries: readonl
50
50
  return entry === undefined;
51
51
  });
52
52
  const stale = entries
53
- .filter((entry) => !used.has(entry))
53
+ .filter((entry) => !(used.has(entry) || (registrable(rules, entry.rule) && (skipped(rules, entry.rule) || halfSkipped(rules, entry.rule)))))
54
54
  .map((entry) => ({
55
55
  entry,
56
56
  problem: registrable(rules, entry.rule) ? unusedEntryProblem(rules, entry.rule, "matches no violation") : UNREGISTRABLE,
@@ -1,11 +1,14 @@
1
1
  import * as NodePath from "@effect/platform-node/NodePath";
2
- import { Console, Effect, Path } from "effect";
2
+ import { Config, Console, Effect, Path } from "effect";
3
3
  import { ChildProcess, ChildProcessSpawner } from "effect/process";
4
4
  import { readPackageManifest } from "#adapters/manifestInventory.ts";
5
5
  import { manifestReader } from "#adapters/manifestReader.ts";
6
- import { lint } from "#cli/lint.ts";
6
+ import { reportLint } from "#cli/lint.ts";
7
7
  import { loadConfig } from "#config/load.ts";
8
+ import { passes } from "#engine/evaluate.ts";
8
9
  import { GateFailed, SetupFailure } from "#failure.ts";
10
+ import { stagedCheck } from "#hooks/stagedCheck.ts";
11
+ import { recap } from "#report/recap.ts";
9
12
 
10
13
  const COMMIT_AGAIN =
11
14
  "help: fix what the output above reports, then commit again; `quality hooks pre-commit` repeats these checks without committing.";
@@ -41,13 +44,24 @@ const runScript = Effect.fnUntraced(
41
44
  Effect.mapError((error) => new SetupFailure({ cause: error, message: `cannot run a pre-commit script: ${error.message}` })),
42
45
  );
43
46
 
47
+ const inCloudSession = Config.String("CLAUDE_CODE_REMOTE").pipe(
48
+ Config.withDefault(""),
49
+ Config.map((value) => value === "true"),
50
+ );
51
+
44
52
  export const preCommitHook = Effect.fn("Hooks.preCommitHook")(function* (cwd: string, path: string | undefined) {
45
53
  const config = yield* loadConfig(cwd, path);
54
+ const cloud = yield* inCloudSession.pipe(Effect.mapError((cause) => new SetupFailure({ cause, message: "cannot read CLAUDE_CODE_REMOTE." })));
55
+ if (config.preCommit === "staged" && !cloud) {
56
+ if (!(yield* stagedCheck(config))) {
57
+ yield* Console.error(`quality: pre-commit failed: Biome on the staged files.\n${COMMIT_AGAIN}`);
58
+ return yield* new GateFailed();
59
+ }
60
+ return;
61
+ }
46
62
  const { manager, scripts } = yield* commitScripts(config.root);
47
- const linted = yield* lint(cwd, path, true).pipe(
48
- Effect.as(true),
49
- Effect.catchTag("GateFailed", () => Effect.succeed(false)),
50
- );
63
+ const { context, outcome } = yield* reportLint(cwd, path, true);
64
+ const linted = passes(outcome);
51
65
  const failed = linted ? [] : ["quality lint"];
52
66
  for (const script of scripts) {
53
67
  const command = `${manager} run ${script}`;
@@ -58,7 +72,8 @@ export const preCommitHook = Effect.fn("Hooks.preCommitHook")(function* (cwd: st
58
72
  }
59
73
  }
60
74
  if (failed.length > 0) {
61
- yield* Console.error(`quality: pre-commit failed: ${failed.join(", ")}.\n${COMMIT_AGAIN}`);
75
+ const findings = linted ? [] : [recap(outcome, context)];
76
+ yield* Console.error([...findings, `quality: pre-commit failed: ${failed.join(", ")}.`, COMMIT_AGAIN].join("\n"));
62
77
  return yield* new GateFailed();
63
78
  }
64
79
  });
@@ -0,0 +1,54 @@
1
+ import * as NodePath from "@effect/platform-node/NodePath";
2
+ import { Console, Effect, Path } from "effect";
3
+ import { manifestReader } from "#adapters/manifestReader.ts";
4
+ import { biomeReport } from "#biome/report.ts";
5
+ import type { ResolvedConfig } from "#config/load.ts";
6
+ import { readBaseline } from "#engine/baselineFile.ts";
7
+ import { evaluate, type Outcome, passes } from "#engine/evaluate.ts";
8
+ import type { Violation } from "#engine/violation.ts";
9
+ import { registryEntries } from "#exceptions/registryEntries.ts";
10
+ import { SetupFailure } from "#failure.ts";
11
+ import { gitOrFail } from "#git/command.ts";
12
+ import { withStagedContent } from "#hooks/withStagedContent.ts";
13
+ import { type ReportContext, renderFindings } from "#report/render.ts";
14
+ import { failingFindings } from "#rules/biome.ts";
15
+
16
+ const BIOME = ["check", "--files-ignore-unknown=true", "--no-errors-on-unmatched"];
17
+
18
+ function pathsOf(output: string): readonly string[] {
19
+ return output.split("\0").filter((path) => path !== "");
20
+ }
21
+
22
+ function failed(error: { readonly message: string }): SetupFailure {
23
+ return new SetupFailure({ cause: error, message: error.message });
24
+ }
25
+
26
+ export const stagedCheck = Effect.fn("Hooks.stagedCheck")(function* (config: ResolvedConfig) {
27
+ const { relative } = yield* Path.Path.pipe(Effect.provide(NodePath.layer));
28
+
29
+ const staged = pathsOf(yield* gitOrFail(config.root, ["diff", "--cached", "--name-only", "--relative", "--diff-filter=d", "-z"]));
30
+ const unstaged = new Set(pathsOf(yield* gitOrFail(config.root, ["diff", "--name-only", "--relative", "-z"])));
31
+ const edited = staged.filter((path) => unstaged.has(path));
32
+ yield* Console.log(
33
+ `quality: checking ${staged.length === 1 ? "the staged file" : `the ${staged.length} staged files`} with Biome only, as preCommit is "staged".`,
34
+ );
35
+ const report =
36
+ staged.length === 0
37
+ ? { diagnostics: [] }
38
+ : yield* withStagedContent(config.root, edited, biomeReport(config.root, BIOME, config.exceptions, staged, config.nonEffectFolders)).pipe(
39
+ Effect.mapError(failed),
40
+ );
41
+ const findings = yield* failingFindings({ readText: yield* manifestReader(config.root) }, report.diagnostics).pipe(Effect.mapError(failed));
42
+ const violations = findings.map((finding): Violation => ({ ...finding, level: "error", rule: `biome/${finding.subject ?? "internal"}` }));
43
+ const baseline = yield* readBaseline(config);
44
+ const evaluated = evaluate(violations, registryEntries(config.exceptions), baseline.entries, config);
45
+ const outcome: Outcome = { ...evaluated, looseBaseline: [], staleBaseline: [], staleRegistry: [], unsplitBaseline: [] };
46
+ const context: ReportContext = {
47
+ baseline: config.baseline,
48
+ checked: staged.length,
49
+ descriptions: new Map(config.active.map((rule) => [rule.id, rule.description])),
50
+ registry: config.exceptions.length === 0 ? config.registry : `${relative(config.root, config.file)} exceptions`,
51
+ };
52
+ yield* Console.log(renderFindings(outcome, context));
53
+ return passes(outcome);
54
+ });