techdebt_sherpa 0.4.0

CLI for technical debt observability and hotspot analysis in Dart and Flutter repositories.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

0.4.0 - 2026-05-29

Added

• Added positional path aliases for diff, allowing techdebt_sherpa diff old.json new.json --format json.

Changed

• Improved diff command UX with clearer help and README examples.
• Improved command examples and documentation for local suite workflows.

Fixed

• Fixed generated report metadata to emit the current techdebt_sherpa package version instead of stale 0.1.0.

0.3.0 - 2026-05-28

Added

• Added optional scan --dep-sherpa-report <path> support for consuming dep_sherpa Darwin iOS/macOS Swift Package Manager readiness fields.
• Added additive platform_migration_debt findings in JSON and Markdown reports for blocked, partial, enforcement, and warning readiness signals reported by dep_sherpa.

Fixed

• Relaxed the analyzer constraint to include 13.x releases so pub.dev scoring stays current with the latest stable analyzer.

0.2.0 - 2026-04-21

Changed

• Standardized default scan output to reports/ and canonical filenames to techdebt_sherpa.json and techdebt_sherpa.md.
• Added report JSON summary fields for schema version, high-severity issue count, hotspot count, and total debt indicators.

Fixed

• Relaxed the analyzer constraint to include 12.1.0 and newer 12.x releases so pub.dev scoring does not lose points on stale constraints.

0.1.8 - 2026-03-11

Changed

• Added dep_sherpa to the Flutter Sherpa Suite links in README.md.

0.1.7 - 2026-03-05

Changed

• Updated the report JSON schema canonical URI to https://carlosf.dev/schemas/techdebt_sherpa.report.v1.json.

0.1.6 - 2026-03-05

Changed

• Reduced complexity in git/config/analyzer services while preserving existing behavior.
• Refactored CLI scan flow into smaller internal helpers to improve maintainability and hotspot scores.

0.1.5 - 2026-03-05

Fixed

• Relaxed meta constraint to ^1.17.0 so Flutter projects can resolve 1.17.0 while pub scoring still supports latest 1.18.x.

0.1.4 - 2026-03-05

Fixed

• Constrained meta to >=1.17.0 <1.18.0 to avoid Flutter SDK version-pin conflicts.

0.1.3 - 2026-03-01

Changed

• Ignore local IDE metadata and pana output artifacts in .gitignore.

0.1.2 - 2026-03-01

Changed

• Maintenance release to republish latest suite standards and CI validations.

0.1.1 - 2026-03-01

Added

• Added suite local contract file: SHERPA_SUITE_GUIDELINES.md.
• Added local Codex suite skill at .codex/skills/sherpa_suite.md.

Changed

• README standardized to suite template with required badges, cross-links, and support section.
• analysis_options.yaml aligned to strict suite baseline.
• pubspec.yaml metadata/topics aligned to suite conventions.

0.1.0 - 2026-03-01

Added

• Initial production-ready CLI implementation for scanning Dart/Flutter repositories.
• Static analyzer metrics, git history signals, scoring model, reports, snapshots, trends, and diffs.
• Config system with defaults, docs, tests, and CI workflow.
• MIT LICENSE, contributor policy files, and runnable API example.
• Pub score tooling and gate script (tool/pana_gate.dart) plus doc/pub_score_playbook.md.