Flutter Engine What's New Tool

This directory contains helper scripts for the engine-whats-new skill.

generate_engine_whats_new.dart

Generates the “What's New” summary and diff file for changes in the Flutter engine directory (//engine/src/flutter) between two Flutter releases.

Usage

dart .agents/skills/engine-whats-new/scripts/generate_engine_whats_new.dart --release <TARGET_RELEASE> [--from <BASE_RELEASE>]

Options

• --release, --to, --target <version>: Target Flutter release version (e.g., 3.47).
• --from, --base <version>: Base Flutter release version (e.g., 3.44). If omitted, the tool automatically deduces the preceding quarterly release.
• --engine-path <path>: Path to the Flutter engine directory relative to the repository root (defaults to engine/src/flutter).
• --output-diff <file>: Filepath to write the generated diff (default: engine_diff_<base>_to_<target>.diff).
• --output-summary <file>: Filepath to write the Markdown summary (default: engine_whats_new_<target>.md).
• --format <markdown|json|text>: Stdout output format (default: markdown).