NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #1728 by repository stars
Latest stable
v1.33.2
Last release 14 days ago
08 Nov 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
149 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
fix(complexity): point the nesting suggestion at the deepest block by @dodoshell in https://github.com/ludo-technologies/pyscn/pull/874
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.33.1...v1.33.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
fix(lcom): don't count inherited calls as variables by @dodoshell in https://github.com/ludo-technologies/pyscn/pull/865
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.33.0...v1.33.1
fix(service): stop auto-detected layers from claiming the root package (#847) by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/855
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.32.5...v1.33.0
analyze.summary.code_duplication_percentage from a cloned-fragment ratio to the percentage of analyzed source lines covered by clones; schema_version is now 2 (#857)clone.statistics.duplicated_lines in analysis output (#857)Nothing published for this version
docs: give polyscan its own README section and align translations by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/840
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.32.4...v1.32.5
Nothing published for this version
fix(deadcode): keep one dead region as one finding by @ump45nose in https://github.com/ludo-technologies/pyscn/pull/834
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.32.3...v1.32.4
fix(analyzer): make circular dependency detection match Python's import-time behavior by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pu
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.32.2...v1.32.3
fix(analyzer): penalize asymmetric call evidence (#792) by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/806
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.32.1...v1.32.2
examples, docs, demo and samples directories by default (#816)min_lines in SLOC and lower the default to 8 (#813)Nothing published for this version
chore: reduce README demo screenshot size by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/781
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.32.0...v1.32.1
community_score so it measures structure, not sparsity (#787).pyscn.toml from relocating the project root (#783)complete_linkage, and unknown config keys are rejected (#797)Nothing published for this version
fix(deadcode): don't report the bare yield that keeps a function a generator by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/773
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.31.3...v1.32.0
.gitignore into the output directory (#778)min_lines/min_nodes when skip_docstrings is set (#777)yield that keeps a function a generator as dead code (#773)fix(parser): accept unparenthesized except lists with three or more types (PEP 758) by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.31.2...v1.31.3
except lists with three or more types (PEP 758) (#769)ci: publish Linux arm64 wheels by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/758
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.31.1...v1.31.2
--config file's directory as the project root (#765)manylinux_2_34 so pip refuses them on unsupported glibc (#762)coupling_count or the risk level; they remain visible in type_hint_dependencies. The from __future__ import annotations special case is removed (#761)pyscn-pre-commit mirror instead of a repo: local hook (#759)Nothing published for this version
feat: add schema_version and document the v1.30.0 key rename by @7487 in https://github.com/ludo-technologies/pyscn/pull/750
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.31.0...v1.31.1
analyze writes every requested report format from a single run instead of one per invocation (#752)schema_version field on analyze JSON/YAML output, and migration docs for the v1.30.0 key rename (#750)from pkg import mod namespace members in CBO the same way as import pkg as mod (#751)fix(analyzer): cap semantic Type-4 similarity below the Type-1 threshold by @7487 in https://github.com/ludo-technologies/pyscn/pull/735
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.30.2...v1.31.0
-o, --output <path> flag for analyze; - streams the report to stdout and skips .pyscn/reports/ (#748)complexity.functions and dead_code collections as [] instead of null (#747)chore(deps): bump the go-dependencies group with 3 updates by @dependabot[bot] in https://github.com/ludo-technologies/pyscn/pull/725
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.30.1...v1.30.2
project_root config key, and report internal import resolution counts in all reports (#740)LoadDefaultConfig free of config discovery (#745)Nothing published for this version
Clean up complexity reporting after PR #697 by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/723
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.30.0...v1.30.1
elif arms as extra nesting levels (#729)AnalyzedFunctions (#723)Nothing published for this version
docs: replace README demo video with report screenshot by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/716
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.29.1...v1.30.0
deps_max_depth now matches the top-ranked chain (#711)analyze JSON/YAML object key to snake_case (#718). The complexity, cbo, lcom, and system objects emitted Go PascalCase field names, and the config objects of cbo, lcom, and community_analysis emitted lowerCamelCase. Consumers reading those keys must be updated; see the output schemas.
Functions -> functions, Metrics -> metrics, Summary -> summary, Classes -> classes, Name -> name, FilePath -> file_path, StartLine -> start_line, EndLine -> end_line, RiskLevel -> risk_level, Complexity -> complexity, CognitiveComplexity -> cognitive_complexity, NestingDepth -> nesting_depth, SLOC -> sloc, CouplingCount -> coupling_count, DependentClasses -> dependent_classes, AverageCBO -> average_cbo, LCOM4 -> lcom4, AverageLCOM -> average_lcom, ProjectRoot -> project_root, DependencyAnalysis -> dependency_analysis, CircularDependencies -> circular_dependencies, ArchitectureAnalysis -> architecture_analysis, SRPViolations -> srp_violations.complexity.request and dead_code.request objects follow the same rule (Paths -> paths, MinComplexity -> min_complexity, MinSeverity -> min_severity, ...). The config objects change from lowerCamelCase: minCBO -> min_cbo, maxLCOM -> max_lcom, lowThreshold -> low_threshold, sortBy -> sort_by, minCommunitySize -> min_community_size, includeStdLib -> include_std_lib, ...summary, the dead_code findings, clone, community_analysis (other than config), module_quality, and suggestions were already snake_case.check --allow-parse-errors to syntax and parser failures (#704). Missing, unreadable, and permission-denied files still fail the gate.main*.py now also matches pkg/main_utils.py; add a directory segment to constrain the rule.__init__, __new__, and __post_init__ initialize every attribute of a class, so keeping them in the graph joined all the responsibility clusters they set up. The attributes they introduce still count toward instance_variables.Nothing published for this version
feat(complexity): add per-function SLOC metric and long-function warnings (#551) by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/66
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.29.0...v1.29.1
check, not just the reported ones (#712)check gate on files that cannot be parsed and gate clone detection (#703)--min-complexity from shrinking the analyzed function set and health score (#697)fix(domain): preserve architecture suggestion identity by @yhay81 in https://github.com/ludo-technologies/pyscn/pull/652
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.28.0...v1.29.0
file_path/start_line (#648)Nothing published for this version
docs: point cross-language link to polyscan instead of archived jscan by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/681
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.27.0...v1.28.0
migrate: adopt core/clone from polyscan (grouping, dedup, similarity gates, classifier) by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.26.4...v1.27.0
Nothing published for this version
fix(analyzer): exclude same-file top-level peer classes from CBO (#637) by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/639
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.26.3...v1.26.4
recursive override in MCP analyze tool (#656)check command on malformed discovered .pyscn.toml (#654)fix: ignore module constants in CBO dependencies by @sanmaxdev in https://github.com/ludo-technologies/pyscn/pull/638
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.26.2...v1.26.3
functions_total) in complexity summary (#635)re.DOTALL) in CBO dependencies (#638)feat(analyzer): exclude abstract methods from LCOM4 grouping (#559) by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/625
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.26.1...v1.26.2
docs(readme): refresh Features section with five analysis angles by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/621
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.26.0...v1.26.1
test_*.py, *_test.py) not matching files in nested directories (#532)fix(cbo): don't count a class defined within a class as coupling by @StressTestor in https://github.com/ludo-technologies/pyscn/pull/562
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.25.0...v1.26.0
cli-analysis Agent Skill for CI setup and report generation without MCPhealth-check, refactoring, and architecture-review skills for better trigger accuracyskills/<name>/SKILL.md so Claude Code discovers it; the previous flat skills/SKILL.md layout was never loadedclaude mcp add, not claude_desktop_config.json)feat(analyzer): build CommunityGraph from DependencyGraph (issue #579) by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/587
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.24.3...v1.25.0
--select communities and [communities] config, opt-in (#583)pyscn analyze; opt out with --skip-communities or [communities] enabled = false (#605)Nothing published for this version
fix(lcom): count self. reads as method-call edges by @StressTestor in https://github.com/ludo-technologies/pyscn/pull/558
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.24.2...v1.24.3
[codex] Use cognitive metrics for complexity risk by @LunaHeys in https://github.com/ludo-technologies/pyscn/pull/552
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.24.1...v1.24.2
fix(analyze): calibrate progress bar with actual task timings by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/541
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.24.0...v1.24.1
Nothing published for this version
fix(parser): preserve every elif in a chain so complexity isn't undercounted (#511) by @StressTestor in https://github.com/ludo-technologies/pyscn/pul
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.23.2...v1.24.0
Nothing published for this version
fix(clone): penalize Type-4 similarity for disjoint string literal vocabularies by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/534
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.23.1...v1.23.2
fix(score): soften CBO coupling scoring calibration by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/528
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.23.0...v1.23.1
fix(dead-code): merge overlapping unreachable findings (#471) by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/519
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.22.9...v1.23.0
layered, hexagonal, clean, mvc) for dependency rule configuration (#520, #521, #523, #526)Nothing published for this version
fix(security): clear dependency CVEs and suppress math/rand false positive by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/513
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.22.8...v1.22.9
Nothing published for this version
ci: upgrade golangci-lint-action to v7 by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/507
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.22.7...v1.22.8
.claude-plugin/ directory (#509)Nothing published for this version
Fix module import branch traversal by @M-Hassan-Raza in https://github.com/ludo-technologies/pyscn/pull/502
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.22.6...v1.22.7
id and type in clone group output (#503)Nothing published for this version
Fix nested function CFG collection by @M-Hassan-Raza in https://github.com/ludo-technologies/pyscn/pull/497
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.22.5...v1.22.6
Fix analyzer import and report contracts by @M-Hassan-Raza in https://github.com/ludo-technologies/pyscn/pull/495
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.22.4...v1.22.5
fix(clones): compute TotalClones from clone group membership by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/487
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.22.3...v1.22.4
Nothing published for this version
fix(lcom): detect external ctypes fields by @DaisukeYoda in https://github.com/ludo-technologies/pyscn/pull/480
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.22.2...v1.22.3
skip_docstrings config in clone detection (#483)Fix CBO dependency identity by @M-Hassan-Raza in https://github.com/ludo-technologies/pyscn/pull/474
Full Changelog: https://github.com/ludo-technologies/pyscn/compare/v1.22.1...v1.22.2
WeightedViolations so architecture ComplianceScore is reproducible (#476)One column per month.