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.
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/CHANGELOG.md +74 -1
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/CONTRIBUTING.md +19 -6
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/Cargo.lock +1 -1
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/Cargo.toml +1 -1
- smelt_cli-0.5.0/PKG-INFO +179 -0
- smelt_cli-0.5.0/README.md +163 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/adoption.md +56 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/cli.md +2 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/integrations.md +4 -4
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/README.md +8 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT108.md +3 -3
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT309.md +2 -2
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT321.md +1 -1
- smelt_cli-0.5.0/docs/rules/SMT324.md +53 -0
- smelt_cli-0.5.0/docs/rules/SMT325.md +34 -0
- smelt_cli-0.5.0/docs/rules/SMT326.md +42 -0
- smelt_cli-0.5.0/docs/rules/SMT327.md +43 -0
- smelt_cli-0.5.0/docs/rules/SMT328.md +44 -0
- smelt_cli-0.5.0/docs/rules/SMT329.md +42 -0
- smelt_cli-0.5.0/docs/rules/SMT330.md +43 -0
- smelt_cli-0.5.0/docs/rules/SMT431.md +42 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/structure.md +60 -4
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/upgrading.md +53 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/pyproject.toml +2 -1
- smelt_cli-0.5.0/smelt/analysis/call_order.py +166 -0
- smelt_cli-0.5.0/smelt/analysis/discriminators.py +135 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/none_defaults.py +27 -7
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/parsing.py +3 -10
- smelt_cli-0.5.0/smelt/analysis/providers.py +183 -0
- smelt_cli-0.5.0/smelt/analysis/settings.py +176 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/app.py +41 -27
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/commands/adopt.py +44 -2
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/models.py +3 -3
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/debt.py +92 -28
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/docs.py +16 -13
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/evaluation.py +24 -21
- smelt_cli-0.5.0/smelt/engine/workspace.py +11 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/activation.py +7 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/catalog.json +122 -1
- smelt_cli-0.5.0/smelt/rules/dependencies/fanout.py +152 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/registry.py +8 -0
- smelt_cli-0.5.0/smelt/rules/structure/call_order.py +48 -0
- smelt_cli-0.5.0/smelt/rules/structure/discriminators.py +56 -0
- smelt_cli-0.5.0/smelt/rules/structure/exports.py +79 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/headers.py +39 -2
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/naming.py +40 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/none_defaults.py +6 -2
- smelt_cli-0.5.0/smelt/rules/structure/providers.py +48 -0
- smelt_cli-0.5.0/smelt/rules/structure/settings.py +50 -0
- smelt_cli-0.5.0/smelt/rules/testing/randomness.py +76 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt.schema.json +482 -31
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt.yml +8 -0
- smelt_cli-0.5.0/tests/cli/commands/test_adopt.py +169 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/cli/test_app.py +5 -3
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/cli/test_session.py +1 -2
- smelt_cli-0.5.0/tests/diagnostics/test_debt.py +154 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_changes.py +20 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_staged.py +36 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_fanout.py +117 -0
- smelt_cli-0.5.0/tests/rules/structure/test_call_order.py +86 -0
- smelt_cli-0.5.0/tests/rules/structure/test_discriminators.py +318 -0
- smelt_cli-0.5.0/tests/rules/structure/test_exports.py +84 -0
- smelt_cli-0.5.0/tests/rules/structure/test_headers.py +354 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_members.py +36 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_naming.py +72 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_none_defaults.py +106 -4
- smelt_cli-0.5.0/tests/rules/structure/test_providers.py +115 -0
- smelt_cli-0.5.0/tests/rules/structure/test_settings.py +106 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/test_activation.py +1 -0
- smelt_cli-0.5.0/tests/rules/testing/__init__.py +0 -0
- smelt_cli-0.5.0/tests/rules/testing/test_randomness.py +108 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/uv.lock +1 -1
- smelt_cli-0.4.0/PKG-INFO +0 -118
- smelt_cli-0.4.0/README.md +0 -102
- smelt_cli-0.4.0/smelt/engine/workspace.py +0 -5
- smelt_cli-0.4.0/smelt/rules/dependencies/fanout.py +0 -81
- smelt_cli-0.4.0/tests/rules/structure/test_headers.py +0 -179
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.editorconfig +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.gitattributes +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.github/dependabot.yml +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.github/pull_request_template.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.github/workflows/ci.yml +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.github/workflows/release.yml +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.gitignore +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.pre-commit-config.yml +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.pre-commit-hooks.yaml +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/.python-version +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/README.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/agent-workflow.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/architecture.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/incremental-followup-2026-10-31.json +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/native-checks-2026-10-31.json +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/native-git-retained-state-2026-10-31.json +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/precommit-performance-2026-10-30.json +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/review-feedback-2026-10-31.json +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/staged-checks-2026-10-30.json +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/benchmarks/staged-policy-cache-2026-10-31.json +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/configuration.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/facade-export-evaluation.json +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/proposals/config-structure.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/review.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rule-selection.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT101.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT102.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT103.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT104.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT105.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT106.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT107.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT109.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT301.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT302.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT305.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT306.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT307.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT308.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT310.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT311.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT312.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT313.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT314.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT315.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT316.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT317.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT318.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT319.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT320.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT322.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT323.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT401.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT420.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT421.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT422.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT423.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT424.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT425.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT426.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT427.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT428.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT429.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT430.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT901.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT902.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/rules/SMT903.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/test-quality-evaluation.json +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/testing.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/docs/vision.md +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/native/git.rs +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/native/main.rs +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/native/worker.rs +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/benchmark_checks.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/benchmark_hooks.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/benchmark_session.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/evaluate.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/generate.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/scripts/smoke_distribution.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/__main__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/annotations.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/cache.py +45 -45
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/context.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/contracts.py +26 -26
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/coverage.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/definition_blocks.py +377 -377
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/enum_values.py +14 -14
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/errors.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/exports.py +27 -27
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/facade_usage.py +36 -36
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/files.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/function_usage.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/graphs.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/identity.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/import_cache.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/imports.py +14 -14
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/lazy_exports.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/literals.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/member_state.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/members.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/module_symbols.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/navigation.py +71 -71
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/none_default_rewrite.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/ordering.py +190 -190
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/ordering_rewrite.py +28 -28
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/package_exports.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/python_version.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/retained.py +10 -10
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/syntax.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_awaits.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_cases.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_deadlines.py +28 -28
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_helpers.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_outcomes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_subprocesses.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_syntax.py +96 -96
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/test_timing.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/type_dispatch.py +24 -24
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/analysis/workspace.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/commands/__init__.py +10 -10
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/commands/check.py +51 -51
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/commands/discover.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/commands/info.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/session.py +35 -35
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/session_slots.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/cli/support.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/composition.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/discovery.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/errors.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/loader.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/patterns.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/schema.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/source.py +3 -3
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/config/validation.py +8 -8
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/dedupe.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/groups.py +5 -5
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/render/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/render/machine.py +4 -4
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/render/text.py +4 -4
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/report.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/suppressions.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/diagnostics/violation.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/briefing.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/cache.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/changes.py +38 -38
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/check.py +94 -94
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/coverage.py +12 -12
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/file_checks.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/git_source.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/inference.py +50 -50
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/mirror_inference.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/native_git.py +49 -49
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/none_default_fixes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/ordering_fixes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/paths.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/result_cache.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/rule_settings.py +33 -33
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/schema.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/source_fixes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/engine/staged.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/model/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/model/architecture.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/py.typed +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/base.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/common.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/composition_root.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/cycles.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/facades.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/features.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/interfaces.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/layers.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/dependencies/third_party.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/member_names.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/meta.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/assignments.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/contracts.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/coverage.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/enum_values.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/import_style.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/layout.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/members.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/module_symbols.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/navigation.py +21 -21
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/ordering.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/package_imports.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/structure/type_dispatch.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/awaits.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/cases.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/location.py +103 -103
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/mocking.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/outcomes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/private_access.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/public_attributes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/public_functions.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/smelt/rules/testing/timing.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_annotations.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_context.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_contracts.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_enum_values.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_exports.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_identity.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_lazy_exports.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_module_symbols.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_none_default_rewrite.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_none_defaults.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_ordering.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_ordering_rewrite.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_parsing.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_python_version.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_retained.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_awaits.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_cases.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_deadlines.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_helpers.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_outcomes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_syntax.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_test_timing.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_type_dispatch.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/analysis/test_workspace.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/cli/__init__.py +0 -0
- {smelt_cli-0.4.0/tests/config → smelt_cli-0.5.0/tests/cli/commands}/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/cli/test_session_slots.py +0 -0
- {smelt_cli-0.4.0/tests/diagnostics → smelt_cli-0.5.0/tests/config}/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/config/test_composition.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/config/test_loader.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/config/test_validation.py +0 -0
- {smelt_cli-0.4.0/tests/diagnostics/render → smelt_cli-0.5.0/tests/diagnostics}/__init__.py +0 -0
- {smelt_cli-0.4.0/tests/engine → smelt_cli-0.5.0/tests/diagnostics/render}/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/diagnostics/render/conftest.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/diagnostics/render/test_machine.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/diagnostics/render/test_text.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/diagnostics/test_groups.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/diagnostics/test_suppressions.py +0 -0
- {smelt_cli-0.4.0/tests/fixtures/gateway/src/gateway → smelt_cli-0.5.0/tests/engine}/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_briefing.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_cache.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_check.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_coverage.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_evaluation.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_file_checks.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_inference.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_mirror_inference.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_native_git.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_none_default_fixes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_ordering_fixes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_paths.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_rule_settings.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_schema.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/engine/test_source_fixes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/smelt.yml +0 -0
- {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
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/bootstrap.py +0 -0
- {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
- {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
- {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
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/billing/application/invoices.py +0 -0
- {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
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/billing/domain/money.py +0 -0
- {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
- {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
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/voice/api/routes.py +0 -0
- {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
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/voice/application/ports.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/voice/application/session.py +0 -0
- {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
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/voice/domain/session.py +0 -0
- {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
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/features/voice/infra/sql.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/main.py +0 -0
- {smelt_cli-0.4.0/tests/model → smelt_cli-0.5.0/tests/fixtures/gateway/src/gateway/shared}/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/fixtures/gateway/src/gateway/shared/clock.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/helpers.py +0 -0
- {smelt_cli-0.4.0/tests/rules → smelt_cli-0.5.0/tests/model}/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/model/test_architecture.py +0 -0
- {smelt_cli-0.4.0/tests/rules/dependencies → smelt_cli-0.5.0/tests/rules}/__init__.py +0 -0
- {smelt_cli-0.4.0/tests/rules/structure → smelt_cli-0.5.0/tests/rules/dependencies}/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_composition_root.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_cycles.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_facades.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_features.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_interfaces.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_layers.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/dependencies/test_third_party.py +0 -0
- {smelt_cli-0.4.0/tests/rules/testing → smelt_cli-0.5.0/tests/rules/structure}/__init__.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_assignments.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_contracts.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_coverage.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_enum_values.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_import_style.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_layout.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_module_symbols.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_navigation.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_ordering.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_package_imports.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/structure/test_type_dispatch.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/test_registry.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_awaits.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_cases.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_location.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_mocking.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_outcomes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_private_access.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_public_attributes.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_public_functions.py +0 -0
- {smelt_cli-0.4.0 → smelt_cli-0.5.0}/tests/rules/testing/test_timing.py +0 -0
- {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.
|
|
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
|
|
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
|
|
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.
|
|
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.
|
|
273
|
-
git push origin v0.
|
|
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.
|
|
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.
|
smelt_cli-0.5.0/PKG-INFO
ADDED
|
@@ -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.
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
|
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.
|
|
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
|
|