smelt-cli 0.4.0__tar.gz → 0.5.0__tar.gz

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 (395) hide show
  1. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/CHANGELOG.md +74 -1
  2. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/CONTRIBUTING.md +19 -6
  3. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/Cargo.lock +1 -1
  4. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/Cargo.toml +1 -1
  5. smelt_cli-0.5.0/PKG-INFO +179 -0
  6. smelt_cli-0.5.0/README.md +163 -0
  7. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/adoption.md +56 -0
  8. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/cli.md +2 -0
  9. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/integrations.md +4 -4
  10. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/README.md +8 -0
  11. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT108.md +3 -3
  12. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT309.md +2 -2
  13. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT321.md +1 -1
  14. smelt_cli-0.5.0/docs/rules/SMT324.md +53 -0
  15. smelt_cli-0.5.0/docs/rules/SMT325.md +34 -0
  16. smelt_cli-0.5.0/docs/rules/SMT326.md +42 -0
  17. smelt_cli-0.5.0/docs/rules/SMT327.md +43 -0
  18. smelt_cli-0.5.0/docs/rules/SMT328.md +44 -0
  19. smelt_cli-0.5.0/docs/rules/SMT329.md +42 -0
  20. smelt_cli-0.5.0/docs/rules/SMT330.md +43 -0
  21. smelt_cli-0.5.0/docs/rules/SMT431.md +42 -0
  22. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/structure.md +60 -4
  23. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/upgrading.md +53 -0
  24. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/pyproject.toml +2 -1
  25. smelt_cli-0.5.0/smelt/analysis/call_order.py +166 -0
  26. smelt_cli-0.5.0/smelt/analysis/discriminators.py +135 -0
  27. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/none_defaults.py +27 -7
  28. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/parsing.py +3 -10
  29. smelt_cli-0.5.0/smelt/analysis/providers.py +183 -0
  30. smelt_cli-0.5.0/smelt/analysis/settings.py +176 -0
  31. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/app.py +41 -27
  32. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/commands/adopt.py +44 -2
  33. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/models.py +3 -3
  34. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/debt.py +92 -28
  35. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/docs.py +16 -13
  36. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/evaluation.py +24 -21
  37. smelt_cli-0.5.0/smelt/engine/workspace.py +11 -0
  38. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/activation.py +7 -0
  39. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/catalog.json +122 -1
  40. smelt_cli-0.5.0/smelt/rules/dependencies/fanout.py +152 -0
  41. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/registry.py +8 -0
  42. smelt_cli-0.5.0/smelt/rules/structure/call_order.py +48 -0
  43. smelt_cli-0.5.0/smelt/rules/structure/discriminators.py +56 -0
  44. smelt_cli-0.5.0/smelt/rules/structure/exports.py +79 -0
  45. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/headers.py +39 -2
  46. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/naming.py +40 -0
  47. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/none_defaults.py +6 -2
  48. smelt_cli-0.5.0/smelt/rules/structure/providers.py +48 -0
  49. smelt_cli-0.5.0/smelt/rules/structure/settings.py +50 -0
  50. smelt_cli-0.5.0/smelt/rules/testing/randomness.py +76 -0
  51. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt.schema.json +482 -31
  52. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt.yml +8 -0
  53. smelt_cli-0.5.0/tests/cli/commands/test_adopt.py +169 -0
  54. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/cli/test_app.py +5 -3
  55. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/cli/test_session.py +1 -2
  56. smelt_cli-0.5.0/tests/diagnostics/test_debt.py +154 -0
  57. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_changes.py +20 -0
  58. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_staged.py +36 -0
  59. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_fanout.py +117 -0
  60. smelt_cli-0.5.0/tests/rules/structure/test_call_order.py +86 -0
  61. smelt_cli-0.5.0/tests/rules/structure/test_discriminators.py +318 -0
  62. smelt_cli-0.5.0/tests/rules/structure/test_exports.py +84 -0
  63. smelt_cli-0.5.0/tests/rules/structure/test_headers.py +354 -0
  64. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_members.py +36 -0
  65. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_naming.py +72 -0
  66. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_none_defaults.py +106 -4
  67. smelt_cli-0.5.0/tests/rules/structure/test_providers.py +115 -0
  68. smelt_cli-0.5.0/tests/rules/structure/test_settings.py +106 -0
  69. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/test_activation.py +1 -0
  70. smelt_cli-0.5.0/tests/rules/testing/__init__.py +0 -0
  71. smelt_cli-0.5.0/tests/rules/testing/test_randomness.py +108 -0
  72. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/uv.lock +1 -1
  73. smelt_cli-0.4.0/PKG-INFO +0 -118
  74. smelt_cli-0.4.0/README.md +0 -102
  75. smelt_cli-0.4.0/smelt/engine/workspace.py +0 -5
  76. smelt_cli-0.4.0/smelt/rules/dependencies/fanout.py +0 -81
  77. smelt_cli-0.4.0/tests/rules/structure/test_headers.py +0 -179
  78. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.editorconfig +0 -0
  79. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.gitattributes +0 -0
  80. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.github/dependabot.yml +0 -0
  81. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.github/pull_request_template.md +0 -0
  82. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.github/workflows/ci.yml +0 -0
  83. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.github/workflows/release.yml +0 -0
  84. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.gitignore +0 -0
  85. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.pre-commit-config.yml +0 -0
  86. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.pre-commit-hooks.yaml +0 -0
  87. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.python-version +0 -0
  88. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/README.md +0 -0
  89. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/agent-workflow.md +0 -0
  90. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/architecture.md +0 -0
  91. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/incremental-followup-2026-10-31.json +0 -0
  92. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/native-checks-2026-10-31.json +0 -0
  93. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/native-git-retained-state-2026-10-31.json +0 -0
  94. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/precommit-performance-2026-10-30.json +0 -0
  95. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/review-feedback-2026-10-31.json +0 -0
  96. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/staged-checks-2026-10-30.json +0 -0
  97. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/staged-policy-cache-2026-10-31.json +0 -0
  98. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/configuration.md +0 -0
  99. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/facade-export-evaluation.json +0 -0
  100. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/proposals/config-structure.md +0 -0
  101. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/review.md +0 -0
  102. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rule-selection.md +0 -0
  103. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT101.md +0 -0
  104. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT102.md +0 -0
  105. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT103.md +0 -0
  106. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT104.md +0 -0
  107. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT105.md +0 -0
  108. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT106.md +0 -0
  109. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT107.md +0 -0
  110. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT109.md +0 -0
  111. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT301.md +0 -0
  112. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT302.md +0 -0
  113. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT305.md +0 -0
  114. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT306.md +0 -0
  115. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT307.md +0 -0
  116. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT308.md +0 -0
  117. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT310.md +0 -0
  118. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT311.md +0 -0
  119. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT312.md +0 -0
  120. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT313.md +0 -0
  121. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT314.md +0 -0
  122. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT315.md +0 -0
  123. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT316.md +0 -0
  124. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT317.md +0 -0
  125. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT318.md +0 -0
  126. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT319.md +0 -0
  127. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT320.md +0 -0
  128. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT322.md +0 -0
  129. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT323.md +0 -0
  130. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT401.md +0 -0
  131. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT420.md +0 -0
  132. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT421.md +0 -0
  133. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT422.md +0 -0
  134. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT423.md +0 -0
  135. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT424.md +0 -0
  136. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT425.md +0 -0
  137. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT426.md +0 -0
  138. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT427.md +0 -0
  139. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT428.md +0 -0
  140. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT429.md +0 -0
  141. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT430.md +0 -0
  142. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT901.md +0 -0
  143. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT902.md +0 -0
  144. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT903.md +0 -0
  145. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/test-quality-evaluation.json +0 -0
  146. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/testing.md +0 -0
  147. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/vision.md +0 -0
  148. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/native/git.rs +0 -0
  149. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/native/main.rs +0 -0
  150. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/native/worker.rs +0 -0
  151. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/benchmark_checks.py +0 -0
  152. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/benchmark_hooks.py +0 -0
  153. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/benchmark_session.py +0 -0
  154. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/evaluate.py +0 -0
  155. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/generate.py +0 -0
  156. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/smoke_distribution.py +0 -0
  157. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/__init__.py +0 -0
  158. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/__main__.py +0 -0
  159. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/__init__.py +0 -0
  160. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/annotations.py +0 -0
  161. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/cache.py +45 -45
  162. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/context.py +0 -0
  163. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/contracts.py +26 -26
  164. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/coverage.py +0 -0
  165. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/definition_blocks.py +377 -377
  166. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/enum_values.py +14 -14
  167. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/errors.py +0 -0
  168. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/exports.py +27 -27
  169. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/facade_usage.py +36 -36
  170. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/files.py +0 -0
  171. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/function_usage.py +0 -0
  172. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/graphs.py +0 -0
  173. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/identity.py +0 -0
  174. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/import_cache.py +0 -0
  175. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/imports.py +14 -14
  176. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/lazy_exports.py +0 -0
  177. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/literals.py +0 -0
  178. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/member_state.py +0 -0
  179. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/members.py +0 -0
  180. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/module_symbols.py +0 -0
  181. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/navigation.py +71 -71
  182. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/none_default_rewrite.py +0 -0
  183. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/ordering.py +190 -190
  184. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/ordering_rewrite.py +28 -28
  185. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/package_exports.py +0 -0
  186. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/python_version.py +0 -0
  187. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/retained.py +10 -10
  188. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/syntax.py +0 -0
  189. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_awaits.py +0 -0
  190. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_cases.py +0 -0
  191. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_deadlines.py +28 -28
  192. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_helpers.py +0 -0
  193. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_outcomes.py +0 -0
  194. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_subprocesses.py +0 -0
  195. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_syntax.py +96 -96
  196. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_timing.py +0 -0
  197. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/type_dispatch.py +24 -24
  198. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/workspace.py +0 -0
  199. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/__init__.py +0 -0
  200. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/commands/__init__.py +10 -10
  201. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/commands/check.py +51 -51
  202. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/commands/discover.py +0 -0
  203. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/commands/info.py +0 -0
  204. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/session.py +35 -35
  205. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/session_slots.py +0 -0
  206. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/support.py +0 -0
  207. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/__init__.py +0 -0
  208. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/composition.py +0 -0
  209. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/discovery.py +0 -0
  210. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/errors.py +0 -0
  211. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/loader.py +0 -0
  212. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/patterns.py +0 -0
  213. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/schema.py +0 -0
  214. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/source.py +3 -3
  215. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/validation.py +8 -8
  216. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/__init__.py +0 -0
  217. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/dedupe.py +0 -0
  218. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/groups.py +5 -5
  219. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/render/__init__.py +0 -0
  220. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/render/machine.py +4 -4
  221. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/render/text.py +4 -4
  222. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/report.py +0 -0
  223. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/suppressions.py +0 -0
  224. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/violation.py +0 -0
  225. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/__init__.py +0 -0
  226. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/briefing.py +0 -0
  227. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/cache.py +0 -0
  228. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/changes.py +38 -38
  229. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/check.py +94 -94
  230. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/coverage.py +12 -12
  231. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/file_checks.py +0 -0
  232. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/git_source.py +0 -0
  233. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/inference.py +50 -50
  234. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/mirror_inference.py +0 -0
  235. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/native_git.py +49 -49
  236. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/none_default_fixes.py +0 -0
  237. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/ordering_fixes.py +0 -0
  238. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/paths.py +0 -0
  239. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/result_cache.py +0 -0
  240. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/rule_settings.py +33 -33
  241. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/schema.py +0 -0
  242. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/source_fixes.py +0 -0
  243. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/staged.py +0 -0
  244. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/model/__init__.py +0 -0
  245. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/model/architecture.py +0 -0
  246. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/py.typed +0 -0
  247. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/__init__.py +0 -0
  248. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/base.py +0 -0
  249. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/common.py +0 -0
  250. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/__init__.py +0 -0
  251. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/composition_root.py +0 -0
  252. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/cycles.py +0 -0
  253. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/facades.py +0 -0
  254. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/features.py +0 -0
  255. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/interfaces.py +0 -0
  256. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/layers.py +0 -0
  257. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/third_party.py +0 -0
  258. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/member_names.py +0 -0
  259. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/meta.py +0 -0
  260. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/__init__.py +0 -0
  261. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/assignments.py +0 -0
  262. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/contracts.py +0 -0
  263. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/coverage.py +0 -0
  264. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/enum_values.py +0 -0
  265. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/import_style.py +0 -0
  266. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/layout.py +0 -0
  267. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/members.py +0 -0
  268. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/module_symbols.py +0 -0
  269. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/navigation.py +21 -21
  270. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/ordering.py +0 -0
  271. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/package_imports.py +0 -0
  272. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/type_dispatch.py +0 -0
  273. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/__init__.py +0 -0
  274. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/awaits.py +0 -0
  275. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/cases.py +0 -0
  276. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/location.py +103 -103
  277. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/mocking.py +0 -0
  278. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/outcomes.py +0 -0
  279. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/private_access.py +0 -0
  280. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/public_attributes.py +0 -0
  281. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/public_functions.py +0 -0
  282. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/timing.py +0 -0
  283. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/__init__.py +0 -0
  284. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/__init__.py +0 -0
  285. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_annotations.py +0 -0
  286. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_context.py +0 -0
  287. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_contracts.py +0 -0
  288. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_enum_values.py +0 -0
  289. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_exports.py +0 -0
  290. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_identity.py +0 -0
  291. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_lazy_exports.py +0 -0
  292. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_module_symbols.py +0 -0
  293. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_none_default_rewrite.py +0 -0
  294. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_none_defaults.py +0 -0
  295. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_ordering.py +0 -0
  296. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_ordering_rewrite.py +0 -0
  297. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_parsing.py +0 -0
  298. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_python_version.py +0 -0
  299. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_retained.py +0 -0
  300. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_awaits.py +0 -0
  301. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_cases.py +0 -0
  302. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_deadlines.py +0 -0
  303. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_helpers.py +0 -0
  304. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_outcomes.py +0 -0
  305. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_syntax.py +0 -0
  306. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_timing.py +0 -0
  307. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_type_dispatch.py +0 -0
  308. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_workspace.py +0 -0
  309. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/cli/__init__.py +0 -0
  310. {smelt_cli-0.4.0/tests/config → smelt_cli-0.5.0/tests/cli/commands}/__init__.py +0 -0
  311. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/cli/test_session_slots.py +0 -0
  312. {smelt_cli-0.4.0/tests/diagnostics → smelt_cli-0.5.0/tests/config}/__init__.py +0 -0
  313. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/config/test_composition.py +0 -0
  314. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/config/test_loader.py +0 -0
  315. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/config/test_validation.py +0 -0
  316. {smelt_cli-0.4.0/tests/diagnostics/render → smelt_cli-0.5.0/tests/diagnostics}/__init__.py +0 -0
  317. {smelt_cli-0.4.0/tests/engine → smelt_cli-0.5.0/tests/diagnostics/render}/__init__.py +0 -0
  318. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/diagnostics/render/conftest.py +0 -0
  319. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/diagnostics/render/test_machine.py +0 -0
  320. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/diagnostics/render/test_text.py +0 -0
  321. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/diagnostics/test_groups.py +0 -0
  322. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/diagnostics/test_suppressions.py +0 -0
  323. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway → smelt_cli-0.5.0/tests/engine}/__init__.py +0 -0
  324. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_briefing.py +0 -0
  325. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_cache.py +0 -0
  326. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_check.py +0 -0
  327. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_coverage.py +0 -0
  328. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_evaluation.py +0 -0
  329. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_file_checks.py +0 -0
  330. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_inference.py +0 -0
  331. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_mirror_inference.py +0 -0
  332. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_native_git.py +0 -0
  333. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_none_default_fixes.py +0 -0
  334. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_ordering_fixes.py +0 -0
  335. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_paths.py +0 -0
  336. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_rule_settings.py +0 -0
  337. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_schema.py +0 -0
  338. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_source_fixes.py +0 -0
  339. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/smelt.yml +0 -0
  340. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway/features → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway}/__init__.py +0 -0
  341. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/bootstrap.py +0 -0
  342. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway/features/billing → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/features}/__init__.py +0 -0
  343. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway/features/billing/application → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/features/billing}/__init__.py +0 -0
  344. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway/features/billing/domain → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/features/billing/application}/__init__.py +0 -0
  345. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/billing/application/invoices.py +0 -0
  346. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway/features/voice → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/features/billing/domain}/__init__.py +0 -0
  347. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/billing/domain/money.py +0 -0
  348. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway/features/voice/api → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/features/voice}/__init__.py +0 -0
  349. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway/features/voice/application → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/features/voice/api}/__init__.py +0 -0
  350. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/voice/api/routes.py +0 -0
  351. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway/features/voice/domain → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/features/voice/application}/__init__.py +0 -0
  352. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/voice/application/ports.py +0 -0
  353. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/voice/application/session.py +0 -0
  354. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway/features/voice/infra → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/features/voice/domain}/__init__.py +0 -0
  355. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/voice/domain/session.py +0 -0
  356. {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway/shared → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/features/voice/infra}/__init__.py +0 -0
  357. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/voice/infra/sql.py +0 -0
  358. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/main.py +0 -0
  359. {smelt_cli-0.4.0/tests/model → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/shared}/__init__.py +0 -0
  360. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/shared/clock.py +0 -0
  361. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/helpers.py +0 -0
  362. {smelt_cli-0.4.0/tests/rules → smelt_cli-0.5.0/tests/model}/__init__.py +0 -0
  363. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/model/test_architecture.py +0 -0
  364. {smelt_cli-0.4.0/tests/rules/dependencies → smelt_cli-0.5.0/tests/rules}/__init__.py +0 -0
  365. {smelt_cli-0.4.0/tests/rules/structure → smelt_cli-0.5.0/tests/rules/dependencies}/__init__.py +0 -0
  366. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_composition_root.py +0 -0
  367. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_cycles.py +0 -0
  368. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_facades.py +0 -0
  369. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_features.py +0 -0
  370. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_interfaces.py +0 -0
  371. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_layers.py +0 -0
  372. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_third_party.py +0 -0
  373. {smelt_cli-0.4.0/tests/rules/testing → smelt_cli-0.5.0/tests/rules/structure}/__init__.py +0 -0
  374. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_assignments.py +0 -0
  375. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_contracts.py +0 -0
  376. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_coverage.py +0 -0
  377. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_enum_values.py +0 -0
  378. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_import_style.py +0 -0
  379. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_layout.py +0 -0
  380. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_module_symbols.py +0 -0
  381. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_navigation.py +0 -0
  382. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_ordering.py +0 -0
  383. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_package_imports.py +0 -0
  384. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_type_dispatch.py +0 -0
  385. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/test_registry.py +0 -0
  386. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_awaits.py +0 -0
  387. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_cases.py +0 -0
  388. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_location.py +0 -0
  389. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_mocking.py +0 -0
  390. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_outcomes.py +0 -0
  391. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_private_access.py +0 -0
  392. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_public_attributes.py +0 -0
  393. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_public_functions.py +0 -0
  394. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_timing.py +0 -0
  395. {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/test_docs.py +0 -0
@@ -7,6 +7,78 @@ current configuration and complete rule contracts, see the [README](README.md),
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.5.0] - 2026-11-02
11
+
12
+ Report schema 2, YAML version 1 and the default rule set remain unchanged.
13
+ Debt writes now use grouped baseline version 2, which older Smelt versions cannot
14
+ read. Existing version-1 baselines remain readable; unscoped SMT321 debt needs
15
+ review and explicit re-recording. Update installation, hook and CI pins together
16
+ to `0.5.0` (`v0.5.0`) before rewriting baselines, and refresh the editor schema.
17
+ See the [upgrade checklist](docs/upgrading.md#040-to-050).
18
+
19
+ - Contributor checks now require an issue/ticket reference for TODO comments
20
+ through Ruff TD003. Tracked TODOs remain allowed; Smelt's rule catalog is unchanged.
21
+
22
+ - Document SMT317's activation and developer-facing extraction evidence with
23
+ concrete query-helper regressions. Inherited-class exclusions and the existing
24
+ advisory behavior are preserved; no duplicate static-method rule is added.
25
+
26
+ - Optional SMT329 (`rules: {caller-before-callee: hint}`) reviews step-down reading
27
+ order for direct same-visibility functions and ordinary methods. Recursive,
28
+ shadowed and definition-time-dependent pairs are retained; SMT313's public-first
29
+ categories take precedence. No definitions are moved automatically.
30
+
31
+ - Optional SMT328 (`rules: {redundant-dishka-provider: hint}`) reviews Dishka
32
+ provider methods that only forward dependencies to a constructor. Findings
33
+ include a direct registration candidate with recognized decorator options.
34
+ Resource factories and additional logic remain valid; no automatic rewrite.
35
+
36
+ - Optional SMT327 (`rules: {secret-settings-field: warning}`) reviews secret-named
37
+ Pydantic settings fields accepting plain `str`/`bytes`, including optional and
38
+ annotated types. Correct secret types and nonsecret names remain valid.
39
+ Findings omit default values; no annotations or consumers are rewritten.
40
+
41
+ - Optional SMT326 (`rules: {no-base-class-suffix: error}`) reviews class definitions
42
+ such as `_MessageBase`. SMT323 retains its existing prefix semantics. Imports,
43
+ aliases and test classes remain outside scope; no automatic rename.
44
+
45
+ - Optional SMT330 (`rules: {package-only-dunder-all: error}`) restricts module
46
+ `__all__` declarations to package `__init__.py` files. Package overrides and
47
+ reasoned suppressions retain deliberate compatibility exports; no automatic move.
48
+
49
+ - Optional SMT431 (`rules: {nondeterministic-test-data: warning}`) reviews known
50
+ random/UUID data generators in tests and fixtures. Prefer fixed test inputs or
51
+ seeded local generators; intentional randomness tests can retain reasoned
52
+ suppressions. Production generators are unaffected; no automatic rewrite.
53
+
54
+ - SMT108 now reviews mixed package-facade and implementation imports with
55
+ `bundle_imports_at: 2`, includes missing export proposals and blocks bundling
56
+ advice when proposed caller/facade edges close a known runtime import cycle.
57
+
58
+ - Debt baselines now write grouped JSON version 2: repeated rule/path/message
59
+ metadata appears once, while every accepted fingerprint and duplicate occurrence
60
+ remains available for matching. Version-1 files remain readable; `smelt debt
61
+ --prune` upgrades assessed entries without accepting new debt. Use `smelt debt
62
+ --show [PATHS]` for a compact, read-only baseline summary, or add `--format json`
63
+ for the grouped data. [SMT321](docs/rules/SMT321.md) now distinguishes enclosing
64
+ functions in debt and changed checks, so fixing one function cannot silently
65
+ accept an identical new violation in another. Old unscoped SMT321 debt requires
66
+ review and explicit re-recording. See [adoption](docs/adoption.md).
67
+
68
+ - Package contracts now support `module_docstrings: require`, activating
69
+ [SMT325](docs/rules/SMT325.md) `missing-module-docstring` for every analyzed
70
+ production module, including empty package initializers. Empty/blank docstrings
71
+ do not satisfy the requirement. Choose `forbid` for the existing
72
+ [SMT309](docs/rules/SMT309.md) convention; use a reasoned file suppression or an
73
+ explicit nested `allow` policy for exceptions. Defaults remain unchanged.
74
+
75
+ - Optional [SMT324](docs/rules/SMT324.md), enabled with
76
+ `rules: {prefer-str-enum-discriminator: hint}`, reviews single-string `Literal`
77
+ fields named `type`, `kind` or `tag` for shared `StrEnum` members. Keep narrow
78
+ `Literal[EventType.MEMBER]` annotations and matching enum defaults. This syntax
79
+ review does not prove union membership or rewrite code; Python targets before
80
+ 3.11 and general multi-value Literals remain unchanged.
81
+
10
82
  ## [0.4.0] - 2026-11-01
11
83
 
12
84
  Report schema 2, YAML version 1 and the default rule set remain unchanged.
@@ -498,7 +570,8 @@ smelt explain SMT313 --format json
498
570
  - Import fanout, match suggestions and missing-assertion checks are review aids;
499
571
  their default severities differ. Configure policy and severity deliberately.
500
572
 
501
- [Unreleased]: https://github.com/mathisarends/smelt/compare/v0.4.0...HEAD
573
+ [Unreleased]: https://github.com/mathisarends/smelt/compare/v0.5.0...HEAD
574
+ [0.5.0]: https://github.com/mathisarends/smelt/compare/v0.4.0...v0.5.0
502
575
  [0.4.0]: https://github.com/mathisarends/smelt/compare/v0.3.0...v0.4.0
503
576
  [0.3.0]: https://github.com/mathisarends/smelt/compare/v0.2.0...v0.3.0
504
577
  [0.2.0]: https://github.com/mathisarends/smelt/compare/v0.1.6...v0.2.0
@@ -62,7 +62,9 @@ new findings against HEAD. Do not record debt or disable rules to adopt a change
62
62
  Prefer private helpers and test public behavior. A direct unit test of a parser,
63
63
  rewriter or cache invalidation boundary can use a local `SMT420` exception with a
64
64
  specific reason; in multiline imports put it on the imported name. Entry points
65
- used by excluded maintainer scripts have deliberate `__all__` exports.
65
+ used by excluded maintainer scripts retain a specific visibility suppression
66
+ naming the actual consumer. Keep `__all__` declarations in package `__init__.py`
67
+ files; do not add module export lists merely to silence visibility reviews.
66
68
 
67
69
  The checker selects rules through generated `smelt/rules/catalog.json` metadata
68
70
  and imports implementations only when needed. Register implementation paths in
@@ -173,6 +175,17 @@ metadata, and generated-file freshness. Duplicate codes or names also fail when
173
175
 
174
176
  ## Regressions from real projects
175
177
 
178
+ TODO comments must reference the issue or ticket that explains the unfinished
179
+ work. Ruff TD003 checks this convention in local checks and CI. For example:
180
+
181
+ ```python
182
+ # TODO: support the additional layout after the policy is specified.
183
+ # https://github.com/mathisarends/smelt/issues/66
184
+ ```
185
+
186
+ Use an actual issue for the work being deferred. This policy permits tracked
187
+ TODOs; it does not ban them or add a duplicate Smelt diagnostic.
188
+
176
189
  Reduce the example to synthetic files using `tests.helpers.write_project`, or a
177
190
  small layout under `tests/fixtures/`. Keep the behavior that exposed the defect,
178
191
  including workspace roots or namespace portions when relevant. Tests must run
@@ -257,20 +270,20 @@ environment name must match the workflow exactly.
257
270
  ### Release procedure
258
271
 
259
272
  1. Review changes since the last tag. Update the [upgrade guide](docs/upgrading.md),
260
- README feature summary and pinned hook/CI examples in
273
+ README examples and pinned hook/CI examples in
261
274
  [integrations](docs/integrations.md), including any report-format migration.
262
275
  Move `Unreleased` entries to a dated version section and update the changelog's
263
276
  comparison links. Bump matching versions in `pyproject.toml` and `Cargo.toml`,
264
277
  run `uv lock` and `cargo check` to refresh both lockfiles, and merge the release
265
278
  preparation into `main` after CI passes. Each release needs a new PyPI version.
266
279
  2. From an up-to-date, clean `main` checkout, create and push the corresponding tag.
267
- For example, after merging version `0.4.0`:
280
+ For example, after merging version `0.5.0`:
268
281
 
269
282
  ```bash
270
283
  git switch main
271
284
  git pull --ff-only
272
- git tag v0.4.0
273
- git push origin v0.4.0
285
+ git tag v0.5.0
286
+ git push origin v0.5.0
274
287
  ```
275
288
 
276
289
  3. Follow the `Publish to PyPI` run in
@@ -288,7 +301,7 @@ environment name must match the workflow exactly.
288
301
  Maintainers and coding agents with permission to push release tags can use this
289
302
  procedure without local PyPI credentials. Ordinary branch pushes and pull requests
290
303
  do not publish. Manual workflow runs must select an existing `v`-prefixed tag
291
- (`gh workflow run release.yml --ref v0.4.0`); branch runs skip publishing.
304
+ (`gh workflow run release.yml --ref v0.5.0`); branch runs skip publishing.
292
305
 
293
306
  If the upload fails because account configuration is missing, finish that setup
294
307
  and rerun the failed publishing job so it reuses the validated build artifacts.
@@ -1380,7 +1380,7 @@ checksum = "d0d5d4b1981b8bbbb7aed204cae5726d683d5d6ac7e74ec54122ea28f315e7c8"
1380
1380
 
1381
1381
  [[package]]
1382
1382
  name = "smelt-cli"
1383
- version = "0.4.0"
1383
+ version = "0.5.0"
1384
1384
  dependencies = [
1385
1385
  "base64",
1386
1386
  "gix",
@@ -1,6 +1,6 @@
1
1
  [package]
2
2
  name = "smelt-cli"
3
- version = "0.4.0"
3
+ version = "0.5.0"
4
4
  edition = "2024"
5
5
  rust-version = "1.88"
6
6
  publish = false
@@ -0,0 +1,179 @@
1
+ Metadata-Version: 2.4
2
+ Name: smelt-cli
3
+ Version: 0.5.0
4
+ Requires-Dist: grimp>=3.17
5
+ Requires-Dist: packaging>=24.2
6
+ Requires-Dist: pydantic>=2.13.5
7
+ Requires-Dist: pyyaml>=6.0.3
8
+ Summary: Static guardrails for Python codebases maintained by humans and coding agents.
9
+ Author-email: Mathis Arends <mathisarends27@gmail.com>
10
+ Requires-Python: >=3.12
11
+ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
12
+ Project-URL: Documentation, https://github.com/mathisarends/smelt#readme
13
+ Project-URL: Issues, https://github.com/mathisarends/smelt/issues
14
+ Project-URL: Repository, https://github.com/mathisarends/smelt
15
+
16
+ # smelt
17
+
18
+ **A linter for Python architecture boundaries and code smells.**
19
+
20
+ If the same feedback keeps coming up in code review, make it a rule. Smelt puts
21
+ those decisions in `smelt.yml`, where coding agents can read them, check their
22
+ changes and fix findings before opening a PR. Commit hooks and CI enforce the
23
+ same policy.
24
+
25
+ Keep database imports out of application code. Keep package internals behind
26
+ their public API. Catch truthiness fallbacks that discard valid values, or tests
27
+ that wait without a timeout. Choose the checks that match your project from the
28
+ [rule catalog](docs/rules/README.md), or [add a rule](CONTRIBUTING.md) for a
29
+ recurring pattern.
30
+
31
+ ## Get started
32
+
33
+ Requires Python 3.12+. Install **`smelt-cli`** from PyPI:
34
+
35
+ ```bash
36
+ uv tool install smelt-cli
37
+ smelt init --maintainability
38
+ ```
39
+
40
+ Review the generated `smelt.yml`: it proposes a starting policy from your layout
41
+ and selects source and test checks. You decide which conventions to adopt.
42
+ Small libraries can use individual rules without declaring layers or features.
43
+
44
+ ## Turn review feedback into policy
45
+
46
+ For a project with `src/app/` and `tests/`, this policy encodes two recurring
47
+ review comments: application code must not depend on infrastructure, and optional
48
+ defaults should distinguish `None` from valid falsy values.
49
+
50
+ ```yaml
51
+ # smelt.yml
52
+ version: 1
53
+
54
+ project:
55
+ root_packages: [app]
56
+ source_roots: [src]
57
+ test_roots: [tests]
58
+
59
+ architecture:
60
+ layers:
61
+ domain: {path: domain, may_depend_on: []}
62
+ application: {path: application, may_depend_on: [domain]}
63
+ infrastructure: {path: infrastructure, may_depend_on: [domain, application]}
64
+
65
+ rules:
66
+ implicit-optional-default: warning
67
+ unbounded-test-wait: warning
68
+ ```
69
+
70
+ Smelt catches an import that crosses the declared boundary:
71
+
72
+ ```python
73
+ # src/app/application/orders.py
74
+ from app.infrastructure.database import SqlOrderRepository # SMT101
75
+ ```
76
+
77
+ Application code should depend on an interface in an allowed layer; wire the
78
+ concrete repository in your composition root. Smelt also flags this fallback:
79
+
80
+ ```python
81
+ def page_size(limit: int | None = None) -> int:
82
+ return limit or 100 # SMT321: also replaces an explicit 0
83
+ ```
84
+
85
+ If only `None` means "not supplied", use
86
+ `limit if limit is not None else 100`. If treating zero as missing is deliberate,
87
+ keep it with a reasoned exception.
88
+
89
+ ```bash
90
+ smelt check --show-hints --fail-on warning
91
+ smelt explain SMT101 # why it fired and how to fix it
92
+ ```
93
+
94
+ The same configuration can describe [feature boundaries and third-party dependencies](docs/architecture.md),
95
+ [package APIs and source conventions](docs/structure.md), and
96
+ [test conventions](docs/testing.md). Most checks require explicit selection or
97
+ an applicable policy; see [rule activation](docs/rule-selection.md).
98
+
99
+ ## Catch it at commit time
100
+
101
+ Smelt uses the pre-commit hook format. With [prek](https://prek.j178.dev/installation/),
102
+ add this to `.pre-commit-config.yml`:
103
+
104
+ ```yaml
105
+ repos:
106
+ - repo: local
107
+ hooks:
108
+ - id: smelt-staged
109
+ name: smelt
110
+ entry: smelt check --staged --fail-on warning
111
+ language: python
112
+ additional_dependencies: [smelt-cli==0.5.0]
113
+ pass_filenames: false
114
+ always_run: true
115
+ require_serial: true
116
+ ```
117
+
118
+ ```bash
119
+ prek install
120
+ ```
121
+
122
+ The hook installs a pinned wheel in its own environment and checks the Git index,
123
+ including partial staging, deletions and policy changes. New warnings and errors
124
+ block the commit. The agent gets a finding, fixes it, stages the change and retries.
125
+ Existing pre-commit setups can use the same configuration.
126
+
127
+ Use `smelt check --fail-on warning` in CI for the full project check. See
128
+ [integrations](docs/integrations.md) for GitHub Actions, source hooks and other
129
+ installation options. `prek run --all-files` runs the hook too, but the staged
130
+ hook still checks the index; use `smelt check` to review the working tree.
131
+
132
+ ## Give agents a short feedback loop
133
+
134
+ Add this to your `AGENTS.md` or `CLAUDE.md`:
135
+
136
+ ```md
137
+ Before editing, run `smelt context <feature-or-path>` to read the applicable policy.
138
+ After editing, run `smelt check --changed --format json` and address new findings.
139
+ Use `smelt explain <code>` for the rule's intent and repair advice.
140
+ Run focused tests, stage your changes, then run `prek run --all-files`.
141
+ Inspect and stage any hook fixes, and rerun until the checks pass.
142
+ Do not disable rules or record debt just to pass a check.
143
+ ```
144
+
145
+ Findings include locations, evidence and repair advice. Changed checks compare
146
+ with `HEAD` by default; use `--changed --base origin/main` to review a branch.
147
+ For an existing codebase, [debt baselines](docs/adoption.md) let you adopt a policy
148
+ without requiring every old finding to be fixed in the first PR.
149
+
150
+ ### Fast enough to run between edits
151
+
152
+ Local checks reuse a worker and cache analysis by content. Staged checks read Git
153
+ objects directly, including partially staged files, and reuse unchanged results.
154
+ An edit still checks its effects on other modules.
155
+
156
+ One documented benchmark used 250 modules with 12 methods each on Windows 11 /
157
+ Python 3.14. Warm medians, including process startup:
158
+
159
+ | Check | Unchanged retry | After a Python edit |
160
+ | --- | ---: | ---: |
161
+ | Staged CLI, transitive imports + member checks | 49 ms | 380 ms |
162
+ | Complete prek hook, member checks | 227 ms | 612 ms |
163
+
164
+ These are measured examples, not a latency guarantee. The first cache build took
165
+ about 2.6–3.9 seconds in that run; installation and other hooks are excluded.
166
+ See the [setup, raw samples and reproduction commands](docs/agent-workflow.md#native-git-retained-worker-state-and-bounded-failure-handling)
167
+ for the exact policies and timings.
168
+
169
+ ## Learn more
170
+
171
+ - [Configuration](docs/configuration.md) and [rule catalog](docs/rules/README.md)
172
+ - [Upgrading](docs/upgrading.md) and [changelog](CHANGELOG.md)
173
+ - [Documentation index](docs/README.md) and [contributing](CONTRIBUTING.md)
174
+
175
+ Smelt analyzes Python source statically. Use it alongside tests, a type checker
176
+ and Ruff; advisory findings still need review. See [scope and limits](docs/vision.md).
177
+ Run Smelt with a Python version that can parse your code. Release wheels include
178
+ the native client; building from source requires Rust 1.88+ and a platform linker.
179
+
@@ -0,0 +1,163 @@
1
+ # smelt
2
+
3
+ **A linter for Python architecture boundaries and code smells.**
4
+
5
+ If the same feedback keeps coming up in code review, make it a rule. Smelt puts
6
+ those decisions in `smelt.yml`, where coding agents can read them, check their
7
+ changes and fix findings before opening a PR. Commit hooks and CI enforce the
8
+ same policy.
9
+
10
+ Keep database imports out of application code. Keep package internals behind
11
+ their public API. Catch truthiness fallbacks that discard valid values, or tests
12
+ that wait without a timeout. Choose the checks that match your project from the
13
+ [rule catalog](docs/rules/README.md), or [add a rule](CONTRIBUTING.md) for a
14
+ recurring pattern.
15
+
16
+ ## Get started
17
+
18
+ Requires Python 3.12+. Install **`smelt-cli`** from PyPI:
19
+
20
+ ```bash
21
+ uv tool install smelt-cli
22
+ smelt init --maintainability
23
+ ```
24
+
25
+ Review the generated `smelt.yml`: it proposes a starting policy from your layout
26
+ and selects source and test checks. You decide which conventions to adopt.
27
+ Small libraries can use individual rules without declaring layers or features.
28
+
29
+ ## Turn review feedback into policy
30
+
31
+ For a project with `src/app/` and `tests/`, this policy encodes two recurring
32
+ review comments: application code must not depend on infrastructure, and optional
33
+ defaults should distinguish `None` from valid falsy values.
34
+
35
+ ```yaml
36
+ # smelt.yml
37
+ version: 1
38
+
39
+ project:
40
+ root_packages: [app]
41
+ source_roots: [src]
42
+ test_roots: [tests]
43
+
44
+ architecture:
45
+ layers:
46
+ domain: {path: domain, may_depend_on: []}
47
+ application: {path: application, may_depend_on: [domain]}
48
+ infrastructure: {path: infrastructure, may_depend_on: [domain, application]}
49
+
50
+ rules:
51
+ implicit-optional-default: warning
52
+ unbounded-test-wait: warning
53
+ ```
54
+
55
+ Smelt catches an import that crosses the declared boundary:
56
+
57
+ ```python
58
+ # src/app/application/orders.py
59
+ from app.infrastructure.database import SqlOrderRepository # SMT101
60
+ ```
61
+
62
+ Application code should depend on an interface in an allowed layer; wire the
63
+ concrete repository in your composition root. Smelt also flags this fallback:
64
+
65
+ ```python
66
+ def page_size(limit: int | None = None) -> int:
67
+ return limit or 100 # SMT321: also replaces an explicit 0
68
+ ```
69
+
70
+ If only `None` means "not supplied", use
71
+ `limit if limit is not None else 100`. If treating zero as missing is deliberate,
72
+ keep it with a reasoned exception.
73
+
74
+ ```bash
75
+ smelt check --show-hints --fail-on warning
76
+ smelt explain SMT101 # why it fired and how to fix it
77
+ ```
78
+
79
+ The same configuration can describe [feature boundaries and third-party dependencies](docs/architecture.md),
80
+ [package APIs and source conventions](docs/structure.md), and
81
+ [test conventions](docs/testing.md). Most checks require explicit selection or
82
+ an applicable policy; see [rule activation](docs/rule-selection.md).
83
+
84
+ ## Catch it at commit time
85
+
86
+ Smelt uses the pre-commit hook format. With [prek](https://prek.j178.dev/installation/),
87
+ add this to `.pre-commit-config.yml`:
88
+
89
+ ```yaml
90
+ repos:
91
+ - repo: local
92
+ hooks:
93
+ - id: smelt-staged
94
+ name: smelt
95
+ entry: smelt check --staged --fail-on warning
96
+ language: python
97
+ additional_dependencies: [smelt-cli==0.5.0]
98
+ pass_filenames: false
99
+ always_run: true
100
+ require_serial: true
101
+ ```
102
+
103
+ ```bash
104
+ prek install
105
+ ```
106
+
107
+ The hook installs a pinned wheel in its own environment and checks the Git index,
108
+ including partial staging, deletions and policy changes. New warnings and errors
109
+ block the commit. The agent gets a finding, fixes it, stages the change and retries.
110
+ Existing pre-commit setups can use the same configuration.
111
+
112
+ Use `smelt check --fail-on warning` in CI for the full project check. See
113
+ [integrations](docs/integrations.md) for GitHub Actions, source hooks and other
114
+ installation options. `prek run --all-files` runs the hook too, but the staged
115
+ hook still checks the index; use `smelt check` to review the working tree.
116
+
117
+ ## Give agents a short feedback loop
118
+
119
+ Add this to your `AGENTS.md` or `CLAUDE.md`:
120
+
121
+ ```md
122
+ Before editing, run `smelt context <feature-or-path>` to read the applicable policy.
123
+ After editing, run `smelt check --changed --format json` and address new findings.
124
+ Use `smelt explain <code>` for the rule's intent and repair advice.
125
+ Run focused tests, stage your changes, then run `prek run --all-files`.
126
+ Inspect and stage any hook fixes, and rerun until the checks pass.
127
+ Do not disable rules or record debt just to pass a check.
128
+ ```
129
+
130
+ Findings include locations, evidence and repair advice. Changed checks compare
131
+ with `HEAD` by default; use `--changed --base origin/main` to review a branch.
132
+ For an existing codebase, [debt baselines](docs/adoption.md) let you adopt a policy
133
+ without requiring every old finding to be fixed in the first PR.
134
+
135
+ ### Fast enough to run between edits
136
+
137
+ Local checks reuse a worker and cache analysis by content. Staged checks read Git
138
+ objects directly, including partially staged files, and reuse unchanged results.
139
+ An edit still checks its effects on other modules.
140
+
141
+ One documented benchmark used 250 modules with 12 methods each on Windows 11 /
142
+ Python 3.14. Warm medians, including process startup:
143
+
144
+ | Check | Unchanged retry | After a Python edit |
145
+ | --- | ---: | ---: |
146
+ | Staged CLI, transitive imports + member checks | 49 ms | 380 ms |
147
+ | Complete prek hook, member checks | 227 ms | 612 ms |
148
+
149
+ These are measured examples, not a latency guarantee. The first cache build took
150
+ about 2.6–3.9 seconds in that run; installation and other hooks are excluded.
151
+ See the [setup, raw samples and reproduction commands](docs/agent-workflow.md#native-git-retained-worker-state-and-bounded-failure-handling)
152
+ for the exact policies and timings.
153
+
154
+ ## Learn more
155
+
156
+ - [Configuration](docs/configuration.md) and [rule catalog](docs/rules/README.md)
157
+ - [Upgrading](docs/upgrading.md) and [changelog](CHANGELOG.md)
158
+ - [Documentation index](docs/README.md) and [contributing](CONTRIBUTING.md)
159
+
160
+ Smelt analyzes Python source statically. Use it alongside tests, a type checker
161
+ and Ruff; advisory findings still need review. See [scope and limits](docs/vision.md).
162
+ Run Smelt with a Python version that can parse your code. Release wheels include
163
+ the native client; building from source requires Rust 1.88+ and a platform linker.
@@ -20,6 +20,62 @@ that were fixed and can leave the file (`smelt debt --prune`).
20
20
  Existing debt files remain readable. Run `smelt debt --prune` once before editing imports
21
21
  covered by an older baseline to upgrade their fingerprints; pruning accepts no new debt.
22
22
  New import fingerprints survive comments, aliases and formatting changes.
23
+
24
+ ### Grouped baselines and inspection
25
+
26
+ New writes use debt JSON version 2. Rule, path, message and an optional definition
27
+ scope appear once per group; `fingerprints` contains every accepted matching token.
28
+ One aggregate finding can have several tokens: SMT109 tracks individual importers,
29
+ SMT313 individual ordering inversions, and SMT104 individual cyclic edges. Repeated
30
+ fingerprints retain their multiplicity. A group is not a blanket allowance for
31
+ future imports or inversions, and replacing an accepted edge with a new one still
32
+ reports the new edge. Report JSON remains schema 2; configuration remains version 1.
33
+
34
+ ```json
35
+ {
36
+ "version": 2,
37
+ "violations": [
38
+ {
39
+ "code": "SMT109",
40
+ "path": "app/browser/base.py",
41
+ "message": "BrowserEvents is missing from the package API",
42
+ "scope": "app.browser.base.BrowserEvents",
43
+ "fingerprints": ["accepted-importer-a", "accepted-importer-b"]
44
+ }
45
+ ]
46
+ }
47
+ ```
48
+
49
+ The identifiers above are illustrative; Smelt writes stable hashed fingerprints.
50
+ Version-1 files load with their original counts. `smelt debt --prune` writes the
51
+ grouped format while preserving unassessed entries for inactive or hint-only rules.
52
+ Older Smelt versions cannot read version 2; update local, hook and CI installations
53
+ together before committing an upgraded baseline.
54
+
55
+ Inspect stored debt without analyzing source or changing the baseline/configuration:
56
+
57
+ ```bash
58
+ smelt debt --show # compact text, without hashes
59
+ smelt debt --show app/browser # filter by file or directory
60
+ smelt debt --show app/browser --format json
61
+ ```
62
+
63
+ Paths are relative to the invocation directory. Text lists one rule/path/scope
64
+ and message per group, with its accepted-entry count. JSON exposes the complete
65
+ grouped data and multiplicity. This is the stored baseline, including historical
66
+ messages and unassessed rules; use `smelt check app/browser --format concise` for
67
+ current findings. `--show` and `--prune` are mutually exclusive. Paths and `--format`
68
+ are inspection options only, so recording/pruning always assesses the full project.
69
+
70
+ SMT321 now includes the enclosing function's qualified name in its identity,
71
+ distinguishing methods in different classes and nested functions while surviving
72
+ line shifts. A fixed occurrence cannot pay for an identical new occurrence in
73
+ another function. Old unscoped SMT321 fingerprints cannot establish which function
74
+ was accepted, so those findings require review and explicit re-recording with
75
+ `smelt debt`. `--prune` removes the old tokens without accepting the current findings.
76
+
77
+ ### Architecture edge identities
78
+
23
79
  Cycle debt records each cyclic architecture edge, so a new edge cannot hide behind
24
80
  an existing shortest-cycle witness. Indirect import findings identify the final
25
81
  forbidden target, rather than only the facade. Older cycle and indirect-import debt
@@ -28,6 +28,8 @@ smelt explain SMT101 # rationale, examples and config keys of a
28
28
  smelt rules # full catalog with activation and severity
29
29
  smelt debt # record today's violations as known debt
30
30
  smelt debt --prune # drop debt entries that were fixed
31
+ smelt debt --show src/app # inspect stored debt for a file/directory
32
+ smelt debt --show --format json # inspect the grouped version-2 baseline
31
33
  smelt config show # the resolved config
32
34
  smelt config show --sources --format json # policy inputs and explicit value origins
33
35
  smelt config schema # the JSON schema of smelt.yml
@@ -54,7 +54,7 @@ repos:
54
54
  name: smelt (new staged findings)
55
55
  entry: smelt check --staged --fail-on warning
56
56
  language: python
57
- additional_dependencies: [smelt-cli==0.4.0]
57
+ additional_dependencies: [smelt-cli==0.5.0]
58
58
  pass_filenames: false
59
59
  always_run: true
60
60
  require_serial: true
@@ -73,7 +73,7 @@ can modify files; inspect their changes, rerun and stage the result.
73
73
  Projects already depending on Smelt can instead use a local `language: system`
74
74
  hook with `entry: uv run --locked smelt check --staged --fail-on warning`.
75
75
  To install from source, use `repo: https://github.com/mathisarends/smelt`,
76
- `rev: v0.4.0` and `id: smelt-staged` (or `id: smelt` for full checks). This source
76
+ `rev: v0.5.0` and `id: smelt-staged` (or `id: smelt` for full checks). This source
77
77
  installation requires Rust 1.88+ and a platform linker. Use the release's
78
78
  matching `v`-prefixed Git tag. See the [agent workflow](agent-workflow.md) for
79
79
  cache behavior and limitations. Smelt's disposable `.smelt_cache/` creates its
@@ -94,9 +94,9 @@ Install prek in the CI environment before running it (or use `uvx prek run`).
94
94
  ```yaml
95
95
  - uses: astral-sh/setup-uv@v7
96
96
  - run: prek run --all-files --show-diff-on-failure
97
- - run: uvx --from smelt-cli==0.4.0 smelt check --format github
97
+ - run: uvx --from smelt-cli==0.5.0 smelt check --format github
98
98
  # optional: code scanning
99
- - run: uvx --from smelt-cli==0.4.0 smelt check --format sarif > smelt.sarif || true
99
+ - run: uvx --from smelt-cli==0.5.0 smelt check --format sarif > smelt.sarif || true
100
100
  - uses: github/codeql-action/upload-sarif@v3
101
101
  with:
102
102
  sarif_file: smelt.sarif
@@ -32,6 +32,13 @@
32
32
  | [SMT321](SMT321.md) | implicit-optional-default | structure | explicit | warning |
33
33
  | [SMT322](SMT322.md) | deep-object-navigation | structure | explicit | hint |
34
34
  | [SMT323](SMT323.md) | no-base-class-prefix | structure | explicit | error |
35
+ | [SMT324](SMT324.md) | prefer-str-enum-discriminator | structure | explicit | hint |
36
+ | [SMT325](SMT325.md) | missing-module-docstring | structure | policy | error |
37
+ | [SMT326](SMT326.md) | no-base-class-suffix | structure | explicit | error |
38
+ | [SMT327](SMT327.md) | secret-settings-field | structure | explicit | warning |
39
+ | [SMT328](SMT328.md) | redundant-dishka-provider | structure | explicit | hint |
40
+ | [SMT329](SMT329.md) | caller-before-callee | structure | explicit | hint |
41
+ | [SMT330](SMT330.md) | package-only-dunder-all | structure | explicit | error |
35
42
  | [SMT401](SMT401.md) | test-location | tests | policy | error |
36
43
  | [SMT420](SMT420.md) | private-test-access | tests | explicit | error |
37
44
  | [SMT421](SMT421.md) | forbidden-test-mock | tests | policy | error |
@@ -44,6 +51,7 @@
44
51
  | [SMT428](SMT428.md) | async-mock-without-await-check | tests | explicit | warning |
45
52
  | [SMT429](SMT429.md) | test-only-public-function | tests | explicit | warning |
46
53
  | [SMT430](SMT430.md) | test-only-public-attribute | tests | explicit | warning |
54
+ | [SMT431](SMT431.md) | nondeterministic-test-data | tests | explicit | warning |
47
55
  | [SMT901](SMT901.md) | unused-suppression | meta | default | warning |
48
56
  | [SMT902](SMT902.md) | suppression-without-reason | meta | default | error |
49
57
  | [SMT903](SMT903.md) | resolved-debt | meta | default | warning |
@@ -1,6 +1,6 @@
1
1
  # SMT108 package-import-fanout
2
2
 
3
- One caller imports many implementation modules of the same package.
3
+ One caller spreads a package API across several import paths.
4
4
 
5
5
  - **Category:** dependencies
6
6
  - **Activation:** policy — A package contract sets bundle_imports_at.
@@ -8,7 +8,7 @@ One caller imports many implementation modules of the same package.
8
8
 
9
9
  ## Why
10
10
 
11
- Repeated imports of neighboring implementation modules can indicate a missing package API. This is an opt-in design hint, not proof of poor architecture. Count distinct target modules per source file and contracted package, not statements, symbols, or imports across the whole repository.
11
+ Repeated imports of neighboring implementation modules can indicate a missing package API. This is an opt-in design hint, not proof of poor architecture. Count distinct target modules per source file and contracted package, including its facade when mixed with implementation imports, not statements, symbols, or imports across the whole repository. Findings include missing static exports and a cycle witness for the proposed caller/facade edges. Known cycles block bundling advice. No-cycle-found covers only explicit runtime imports; dynamic imports and implicit package initialization remain unproven.
12
12
 
13
13
  ## Bad
14
14
 
@@ -28,7 +28,7 @@ from app.users.application import DeleteUser, GetUser, UpdateUser
28
28
 
29
29
  ## How to fix
30
30
 
31
- Consider exporting the caller's supported API from the package facade. Check dependency direction and cycles before changing exports. If these independent dependencies are intentional, retain them or adjust the advisory threshold. Declare public: ['.'] to enforce facade-only imports.
31
+ Consider exporting the caller's supported API from the package facade. Use proposed_exports to review missing re-exports. A cycle_check of cycle blocks bundling: keep the imports or resolve dependency direction first. No automatic rewrite is performed. If these independent dependencies are intentional, retain them or adjust the advisory threshold. Declare public: ['.'] to enforce facade-only imports.
32
32
 
33
33
  ## Config
34
34