v1.2.12

[djinn-soul]

Changelog

1.2.12 (2026-02-14)

High-Level Summary

• Core Logic Refactoring: The main entry point logic (cytoscnpy/src/entry_point.rs) has been extensively refactored into a new entry_point module, organizing configuration, detection, command handlers, and execution flow into separate, more manageable files.
• Modularized Fix Command: The dead code fixing command (cytoscnpy/src/commands/fix.rs) has been modularized into a new fix directory, improving maintainability and testability.
• Improved LCOM4 Cohesion Metric: Enhanced the Lack of Cohesion of Methods (LCOM4) metric calculation for greater accuracy. The visitor now correctly identifies and skips static methods and its AST traversal logic better detects field and method usages within complex expressions and statements.
• Framework Cohesion Exemptions: The cohesion quality rule now includes exemptions for common framework-specific classes such as dataclass, attrs classes (@attrs.define, @attrs.mutable), pydantic.BaseModel, and typing.Protocol.
• Refined Secret Detection: Reorganized secret detection logic into a new recognizers module. Introduced entropy scanning fallback when AST parsing fails and refined AST-based recognizers to reduce false positives.
• Enhanced VS Code Extension: Introduced a --client vscode flag for client-specific behavior. Improved Quick-fix actions with 'Fix All' support and better diagnostic-to-finding matching.
• Version Bump: Updated project version to 1.2.12 across Cargo.lock and Cargo.toml.

---

Detailed Changes

Workspace & Tooling

• Cargo.lock: Updated cytoscnpy, cytoscnpy-cli, and cytoscnpy-mcp versions from 1.2.11 to 1.2.12.
• Cargo.toml: Updated workspace package version to 1.2.12. Added complexity and perf clippy lints with warn level.
• benchmark/benchmark_and_verify.py: Added error logging to _check_python_module and _check_skylos functions.

Core Analyzer

• cytoscnpy/src/analyzer/aggregation.rs:
  • Implemented 'Duck Typing Boost' for cross-file references.
  • Modified unreachability logic to preserve definitions if a loose attribute reference exists.
• cytoscnpy/src/cli.rs:
  • Introduced ClientKind enum (Vscode).
  • Added --client argument to CLI.
  • Updated --fix help message for unused variable renaming.

Refactored: Fix Command (cytoscnpy/src/commands/fix/)

• [DELETE] cytoscnpy/src/commands/fix.rs (Refactored to module)
• [NEW] apply.rs: Core logic for applying dead code fixes.
• [NEW] apply_plan.rs: Manages planning of edits (variables, imports, functions, classes).
• [NEW] mod.rs: Defines DeadCodeFixOptions, FixResult, and run_fix_deadcode.
• [NEW] plan.rs: Collection of items to fix and stats printing.
• [NEW] ranges.rs: Utility functions for finding definition ranges and import edits.
• [NEW] tests/: Extensive unit tests for apply logic, imports, and ranges.

Refactored: Entry Point (cytoscnpy/src/entry_point/)

• [MODIFY] cytoscnpy/src/entry_point.rs: Refactored to export sub-modules.
• [NEW] config.rs: AppConfig and setup_configuration.
• [NEW] detection.rs: detect_entry_point_calls for identifying Python script entries.
• [NEW] handlers/: Sub-modules for analysis (context, fix, gates, report, run), metrics, and stats.
• [NEW] paths.rs: Path resolution and argument validation utilities.
• [NEW] run.rs: Main CLI entry point logic (run_with_args).

Metrics & Rules

• cytoscnpy/src/metrics/lcom4.rs:
  • Introduced MethodKind classification.
  • Modified calculate_lcom4 to skip static methods.
  • Expanded AST visitor for more comprehensive usage analysis.
• cytoscnpy/src/rules/quality/complexity.rs:
  • Added Pydantic import tracking.
  • Implemented is_exempt_class for framework-specific classes.
• cytoscnpy/src/rules/secrets/mod.rs: Updated SecretScanner to use fallback scanning.
• [NEW] cytoscnpy/src/rules/secrets/recognizers/: Modularized secret recognizers (ast.rs, custom.rs, entropy.rs, regex.rs, types.rs).
• cytoscnpy/tests/: Added cohesion_exemptions_test.rs and expanded metrics_test.rs.

Documentation & Roadmap

• docs/CLI.md: Updated with --client option details.
• docs/roadmap.md: Added 'Phase 6.x (Editor Client Flag)'.

VS Code Extension (editors/vscode/cytoscnpy/)

• package.json: Updated extension version to 0.1.12. Refined setting descriptions.
• src/analyzer.ts & src/extension.ts: Appended --client vscode to CLI calls.
• src/extension.ts:
  • Implemented filterOverlappingFixes for 'Fix All' actions.
  • Enhanced QuickFixProvider with precise symbol names and rule-specific 'Fix All' actions.
• src/test/: Updated tests for new diagnostic formats and 'Fix All' functionality.

---

This discussion was created from the release v1.2.12.