| # 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 |
| |
| ```bash |
| 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`). |
