detect_unused_code 2.0.0

A fast, zero-dependency Dart and Flutter dead code detector and remediation engine. Finds and safely cleans unused classes, imports, variables, dead code, commented files, and TODOs.

2.0.0

• Major Upgrade: Transformed detect_unused_code into a powerful code remediation and automated cleaning engine while preserving zero external runtime dependencies.
• Automated Cleanup Engine (--clean-all, --clean):
  • Safely deletes 100% commented-out files (--clean-commented-files).
  • Surgically removes dead commented-out code blocks in active files (--clean-dead-blocks).
  • Removes zero-usage dead classes, mixins, widgets, and enums (--clean-dead-classes).
  • Safely privatizes file-internal only public classes to _ClassName (--privatize-internal).
  • Cleans and strips pending // TODO comment lines (--clean-todos).
  • Cleans unused_import and unnecessary_import statements (--clean-unused-imports).
  • Remediates dead null-aware expressions (?. to .) and unreachable dead code (--clean-dead-code).
• Defensive Safety Architecture:
  • Snapshot Backups: Automatically creates complete snapshots in .detect_unused/backups/ before performing any cleanup.
  • Instant Rollback: Allows rolling back active project code to any previous snapshot with detect_unused --restore <id> or detect_unused --restore-latest.
  • Backups Browser: View all existing snapshots with detect_unused --backups.
  • Automated .gitignore Protection: Automatically adds .detect_unused/ to .gitignore to prevent committing backup snapshots.
  • Simulation Mode (--dry-run): Preview planned file deletions and modifications without touching disk.
  • Interactive Confirmation: Prompts for explicit user confirmation before executing changes (bypassable with --yes or -y).
  • Post-Cleanup Health Verification: Automatically runs dart analyze after cleaning and prompts for an auto-rollback if any compiler errors are introduced.
• Full API Documentation: 100% dartdoc documentation coverage on all new classes (BackupManager, BackupManifest, BackupFileEntry, RestoreResult, CodeCleaner, CleanResult).

1.3.2

• Appended line number directly to the file path in the TODO console report (e.g. path/to/file.dart:line) enabling instant clickability in IDE terminals.

1.3.1

• Improved TODO comment scanner to capture all TODO tags across all comments, documentation comments (///), and inline notes, matching the Dart analyzer's dart(todo) diagnostic behavior in IDEs.

1.3.0

• Added comprehensive all-in-one default inspection covering 13 code quality points without requiring extra flags.
• Added Dart Analyzer diagnostics inspection:
  • unused_import: Unused imports across files.
  • unnecessary_import: Duplicate or redundant imports.
  • unused_local_variable: Unused local variables.
  • unused_field: Unused class fields.
  • unused_element: Unused private functions, methods, and elements.
  • dead_code: Unreachable dead code blocks.
  • dead_null_aware_expression: Unnecessary null-aware ?. operators on non-nullable targets.
• Added TODO task tracker: Detects pending // TODO: ... and /* TODO ... */ tasks with exact line numbers, descriptions, and clickable file URIs.
• Enabled file-internal only public classes analysis by default (includeInternal: true).
• Added fine-tuning flags: --todos-only, --diagnostics-only, --no-todos, --no-diagnostics, and --no-internal.
• Updated JSON report export (--json) to serialize all 13 inspection points and categorized diagnostics.
• Added TodoItemResult and DiagnosticIssueResult models with full dartdoc documentation.

1.2.0

• Added comprehensive dartdoc documentation comments across 100% of public API elements (classes, constructors, methods, and properties).
• Enclosed flow control statements in curly braces across all files to conform with curly_braces_in_flow_control_structures lint.
• Added analysis_options.yaml with package:lints/recommended.yaml and formatted all Dart files with dart format.

1.1.0

• Enhanced --json flag to automatically save the audit report as a .json file (detect_unused_code.json) in the current execution directory instead of printing raw JSON to the terminal.
• Added support for specifying a custom JSON output filename (e.g. --json=custom_report.json or --json custom_report.json).
• Added progress bar display during JSON analysis and a clean terminal summary showing the output file location upon completion.

1.0.0

• Initial release of detect_unused_code.
• Full project scan and path-specific scan (--url, --path, positional argument).
• Convenient short CLI command alias detect_unused.
• Detection of unused/dead classes, widgets, mixins, enums, controllers, and models.
• Detection of public classes with file-internal only usage (--include-internal).
• Detection of 100% commented-out files with extracted class names.
• Configurable thresholds for heavily commented files (--threshold).
• Configurable minimum line limits for commented code blocks (--min-lines).
• JSON output format support for CI/CD pipelines (--json).
• Zero external runtime dependencies.
• Programmatic API via UnusedCodeAuditor.
• Broad SDK compatibility (>=2.17.0 <4.0.0).