ci: add cognitive_complexity to dart and flutter package

[unicoderbot]

Summary

Adds optional cognitive_complexity auditing to the dart_package and flutter_package reusable workflows using package:cognitive_complexity via the kevmoo/analytica.dart GitHub Action.

Changes

• Added run_cognitive_complexity boolean input (default: false) to both workflows to opt-in to the audit step
• Added supporting inputs: cognitive_complexity_targets, cognitive_complexity_fail_threshold, cognitive_complexity_fail_on_increase, and cognitive_complexity_diff_base
• Configured fetch-depth to 0 (full history) when cognitive complexity is enabled, and 1 (shallow) otherwise, so diff-based comparisons work correctly
• Added the 🧠 Cognitive Complexity step after Bloc Lint in both workflows
• Updated documentation for both dart_package.md and flutter_package.md with input descriptions and usage examples, including how to enable PR comment posting via pull-requests: write permission

Closes #519

[ryzizub]

LGTM, quick question: is 15 reasonable threshold, im not sure what number is good so asking if its some standart

[marcossevilla]

LGTM, quick question: is 15 reasonable threshold, im not sure what number is good so asking if its some standart

it's the default for the action, so I think we're good with it as threshold based on the tests I've done

[marcossevilla]

@vgvbot /address-review

[unicoderbot]

On it, I'll address the review comments and push the changes.

• Preparing environment
  • Cloning repository
  • Setting up dev environment
• Reviewing feedback
• Working on changes
• Pushing updates

I've pushed changes to address the feedback.