Skip to content

Commit e419044

Browse files
Merge branch 'master' into samples/absorb-pointer-vs-ignore-pointer
2 parents 6e5e3af + 8c631c5 commit e419044

2,841 files changed

Lines changed: 119072 additions & 73696 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
name: engine-whats-new
3+
description: >
4+
Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).
5+
6+
When to use:
7+
- Only activate when explicitly asked by the user to generate what's new in the engine, diff Flutter engine releases, or produce an engine release summary.
8+
9+
When not to use:
10+
- Do not use for general questions about commits, individual file history, or codebase searches unless explicitly requested to generate the engine release diff or summary.
11+
---
12+
13+
# Flutter Engine What's New & Diff Skill
14+
15+
## Workflow
16+
17+
### 1. Identify Inputs
18+
19+
Extract the following from the user's request:
20+
* **Target Release (`<TARGET_RELEASE>`):** The Flutter release version to analyze (e.g., `3.47`, `3.47.0`, or `flutter-3.47-candidate.0`).
21+
* **Base Release (`<BASE_RELEASE>`):** Optional. The prior Flutter release to compare against (e.g., `3.44`). If omitted by the user, the script will automatically calculate the predecessor release (e.g., for `3.47` it automatically selects `3.44`).
22+
23+
### 2. Run the Generator Tool
24+
25+
Execute the Dart script from the Flutter repository root:
26+
27+
```bash
28+
dart .agents/skills/engine-whats-new/scripts/generate_engine_whats_new.dart --release <TARGET_RELEASE>
29+
```
30+
31+
If the user specifies a custom base release or output paths:
32+
33+
```bash
34+
dart .agents/skills/engine-whats-new/scripts/generate_engine_whats_new.dart --release <TARGET_RELEASE> --from <BASE_RELEASE> --output-diff engine_diff_<BASE_RELEASE>_to_<TARGET_RELEASE>.diff --output-summary engine_whats_new_<TARGET_RELEASE>.md
35+
```
36+
37+
To output structured JSON for programmatic consumption:
38+
39+
```bash
40+
dart .agents/skills/engine-whats-new/scripts/generate_engine_whats_new.dart --release <TARGET_RELEASE> --format json
41+
```
42+
43+
### 3. Review Generated Artifacts & Present to User
44+
45+
The tool produces two primary artifacts in the repository root:
46+
1. **Diff File (`engine_diff_<BASE_RELEASE>_to_<TARGET_RELEASE>.diff`):** The full unified git diff of all changes in //engine/src/flutter between the two releases.
47+
2. **Summary Document (`engine_whats_new_<TARGET_RELEASE>.md`):** A categorized Markdown summary covering:
48+
* **Overview & Statistics:** Total engine commits, files changed, additions, and deletions.
49+
* **🚀 Impeller & Graphics Rendering:** Vulkan, Metal, OpenGL, shaders, and display list updates.
50+
* **🌐 Web Engine & Wasm:** Web SDK, CanvasKit, and WebAssembly changes.
51+
* **📱 Android Embedding:** Gradle/AGP updates, Android view rendering, and Java/Kotlin embedding changes.
52+
* **🍎 iOS & macOS Embeddings:** Darwin platform view lifecycle, Metal views, and macOS/iOS updates.
53+
* **🪟 Windows & Linux Desktop Embeddings:** Win32 compositor, Linux GTK embedding, and desktop shell fixes.
54+
* **🔤 Text, Typography & Accessibility:** Semantics, IME, font fallback, and text layout improvements.
55+
* **🔄 Dependency Rolls:** Skia, Dart SDK, ICU, HarfBuzz, and ANGLE rolls.
56+
* **🛠️ Build System, CI & Tooling:** GN build files, luci scripts, and testing utilities.
57+
58+
Provide the user with a concise overview of the results and links to the generated diff and markdown summary files.
59+
60+
## Examples
61+
62+
- **User:** "Generate what's new in the engine for Flutter 3.47."
63+
- **Agent:**
64+
1. Identifies target release `3.47`.
65+
2. Runs `dart .agents/skills/engine-whats-new/scripts/generate_engine_whats_new.dart --release 3.47`.
66+
3. Reports the summary statistics (e.g., 354 commits, 1179 files changed) and shares the generated `engine_diff_3.44_to_3.47.diff` and `engine_whats_new_3.47.md`.
67+
68+
- **User:** "Diff the engine changes between Flutter 3.41 and 3.44."
69+
- **Agent:**
70+
1. Identifies base release `3.41` and target release `3.44`.
71+
2. Runs `dart .agents/skills/engine-whats-new/scripts/generate_engine_whats_new.dart --from 3.41 --to 3.44`.
72+
3. Presents the breakdown of engine changes and the diff file.
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Flutter Engine What's New Tool
2+
3+
This directory contains helper scripts for the `engine-whats-new` skill.
4+
5+
## `generate_engine_whats_new.dart`
6+
7+
Generates the "What's New" summary and diff file for changes in the Flutter engine directory (`//engine/src/flutter`) between two Flutter releases.
8+
9+
### Usage
10+
11+
```bash
12+
dart .agents/skills/engine-whats-new/scripts/generate_engine_whats_new.dart --release <TARGET_RELEASE> [--from <BASE_RELEASE>]
13+
```
14+
15+
### Options
16+
17+
* `--release`, `--to`, `--target <version>`: Target Flutter release version (e.g., `3.47`).
18+
* `--from`, `--base <version>`: Base Flutter release version (e.g., `3.44`). If omitted, the tool automatically deduces the preceding quarterly release.
19+
* `--engine-path <path>`: Path to the Flutter engine directory relative to the repository root (defaults to `engine/src/flutter`).
20+
* `--output-diff <file>`: Filepath to write the generated diff (default: `engine_diff_<base>_to_<target>.diff`).
21+
* `--output-summary <file>`: Filepath to write the Markdown summary (default: `engine_whats_new_<target>.md`).
22+
* `--format <markdown|json|text>`: Stdout output format (default: `markdown`).

0 commit comments

Comments
 (0)