Skip to content

feat(plan): promote planning feature to stable#24282

Merged
ruomengz merged 3 commits intomainfrom
feat/24263-remove-plan-experimental
Mar 31, 2026
Merged

feat(plan): promote planning feature to stable#24282
ruomengz merged 3 commits intomainfrom
feat/24263-remove-plan-experimental

Conversation

@ruomengz
Copy link
Copy Markdown
Contributor

Summary

This PR graduates the "planning" feature from experimental status to a core configuration setting, as tracked in #24263.

Details

  • Moved configuration path from experimental.plan to general.plan.enabled.
  • Added a migration helper in migrateExperimentalSettings to automatically transition existing user configurations while maintaining backward compatibility.
  • Updated the settings schema, documentation, and relevant integration tests/evals to reflect the new stable path.
  • Improved the migrateExperimental helper to correctly handle falsy values during migration.

Related Issues

Fixes #24263

How to Validate

  1. New Configuration: Set general.plan.enabled: true (or false) in settings.json and verify the CLI respects the setting.
  2. Migration: Use an old configuration with experimental.plan: true and verify it is migrated to the new path upon startup.
  3. Tests: Run npm test -w @google/gemini-cli and verify configuration-related tests pass.

Pre-Merge Checklist

  • Updated relevant documentation and README (if needed)
  • Added/updated tests (if needed)
  • Noted breaking changes (if any) - Backward compatibility is maintained via migration.
  • Validated on MacOS (npm run)

@ruomengz ruomengz requested review from a team as code owners March 30, 2026 22:40
@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request promotes the planning feature to a stable, core configuration setting. It updates the configuration schema, documentation, and testing infrastructure to reflect this change while ensuring backward compatibility for existing users through an automated migration process.

Highlights

  • Feature Promotion: Graduated the 'planning' feature from experimental status to a core configuration setting.
  • Configuration Path Update: Migrated the configuration setting from 'experimental.plan' to 'general.plan.enabled'.
  • Backward Compatibility: Implemented a migration helper in 'migrateExperimentalSettings' to automatically transition existing user configurations to the new path.
Ignored Files
  • Ignored by pattern: .gemini/** (1)
    • .gemini/settings.json
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request migrates the plan mode setting from experimental.plan to general.plan.enabled across the documentation, configuration schemas, and test suites. It also includes a migration function to handle existing user settings. One issue was identified in evals/plan_mode.eval.ts where a typo in the property name (enable instead of enabled) would cause the setting to be ignored.

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 30, 2026

Size Change: +693 B (0%)

Total Size: 26.5 MB

Filename Size Change
./bundle/chunk-2ZH2RSWO.js 0 B -14.7 MB (removed) 🏆
./bundle/chunk-4UYB5YAN.js 0 B -3.78 MB (removed) 🏆
./bundle/core-QU2S2VZO.js 0 B -44.6 kB (removed) 🏆
./bundle/devtoolsService-5YZZ3H5H.js 0 B -28.4 kB (removed) 🏆
./bundle/interactiveCli-GI33VOJ7.js 0 B -1.66 MB (removed) 🏆
./bundle/oauth2-provider-5YHHEZPZ.js 0 B -9.16 kB (removed) 🏆
./bundle/chunk-OHO7F2GU.js 14.7 MB +14.7 MB (new file) 🆕
./bundle/chunk-PMQYFHFL.js 3.78 MB +3.78 MB (new file) 🆕
./bundle/core-XP5JKUFZ.js 44.6 kB +44.6 kB (new file) 🆕
./bundle/devtoolsService-I7WYTMFD.js 28.4 kB +28.4 kB (new file) 🆕
./bundle/interactiveCli-ISANPWR7.js 1.66 MB +1.66 MB (new file) 🆕
./bundle/oauth2-provider-22N7IDMP.js 9.16 kB +9.16 kB (new file) 🆕
ℹ️ View Unchanged
Filename Size Change
./bundle/chunk-34MYV7JD.js 2.45 kB 0 B
./bundle/chunk-5AUYMPVF.js 858 B 0 B
./bundle/chunk-664ZODQF.js 124 kB 0 B
./bundle/chunk-DAHVX5MI.js 206 kB 0 B
./bundle/chunk-IUUIT4SU.js 56.5 kB 0 B
./bundle/chunk-PTGY7UXW.js 1.96 MB 0 B
./bundle/chunk-RJTRUG2J.js 39.8 kB 0 B
./bundle/chunk-U4FACSVX.js 1.13 kB 0 B
./bundle/devtools-36NN55EP.js 696 kB 0 B
./bundle/dist-T73EYRDX.js 356 B 0 B
./bundle/events-CLX3JQHP.js 418 B 0 B
./bundle/gemini.js 532 kB -8 B (0%)
./bundle/getMachineId-bsd-TXG52NKR.js 1.55 kB 0 B
./bundle/getMachineId-darwin-7OE4DDZ6.js 1.55 kB 0 B
./bundle/getMachineId-linux-SHIFKOOX.js 1.34 kB 0 B
./bundle/getMachineId-unsupported-5U5DOEYY.js 1.06 kB 0 B
./bundle/getMachineId-win-6KLLGOI4.js 1.72 kB 0 B
./bundle/memoryDiscovery-4PHRORYM.js 980 B 0 B
./bundle/multipart-parser-KPBZEGQU.js 11.7 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js 222 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js 229 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js 13.4 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.js 132 B 0 B
./bundle/sandbox-macos-permissive-open.sb 890 B 0 B
./bundle/sandbox-macos-permissive-proxied.sb 1.31 kB 0 B
./bundle/sandbox-macos-restrictive-open.sb 3.36 kB 0 B
./bundle/sandbox-macos-restrictive-proxied.sb 3.56 kB 0 B
./bundle/sandbox-macos-strict-open.sb 4.82 kB 0 B
./bundle/sandbox-macos-strict-proxied.sb 5.02 kB 0 B
./bundle/src-QVCVGIUX.js 47 kB 0 B
./bundle/tree-sitter-7U6MW5PS.js 274 kB 0 B
./bundle/tree-sitter-bash-34ZGLXVX.js 1.84 MB 0 B

compressed-size-action

@ruomengz ruomengz force-pushed the feat/24263-remove-plan-experimental branch from 84fb7e3 to d3dad96 Compare March 30, 2026 22:46
@gemini-cli gemini-cli bot added area/core Issues related to User Interface, OS Support, Core Functionality 🔒 maintainer only ⛔ Do not contribute. Internal roadmap item. labels Mar 30, 2026
@ruomengz ruomengz force-pushed the feat/24263-remove-plan-experimental branch 2 times, most recently from 0f177e3 to 9312285 Compare March 30, 2026 23:03
@ruomengz ruomengz force-pushed the feat/24263-remove-plan-experimental branch 2 times, most recently from dde3ddd to b95c2b3 Compare March 30, 2026 23:34
- Move planning configuration from experimental.plan to general.plan.enable
- Update settings schema and documentation
- Maintain backward compatibility for experimental.plan
- Improve migrateExperimental helper to handle falsy values

fixes #24263
@ruomengz ruomengz force-pushed the feat/24263-remove-plan-experimental branch from b95c2b3 to 837189e Compare March 31, 2026 12:59
@ruomengz ruomengz force-pushed the feat/24263-remove-plan-experimental branch from 837189e to 3e64139 Compare March 31, 2026 13:16
@ruomengz ruomengz enabled auto-merge March 31, 2026 13:56
@ruomengz ruomengz added this pull request to the merge queue Mar 31, 2026
Merged via the queue into main with commit 07e2053 Mar 31, 2026
27 of 28 checks passed
@ruomengz ruomengz deleted the feat/24263-remove-plan-experimental branch March 31, 2026 16:48
@jerop
Copy link
Copy Markdown
Contributor

jerop commented Apr 1, 2026

/patch preview

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 1, 2026

🚀 [Step 1/4] Patch workflow(s) waiting for approval!

📋 Details:

  • Channels: preview
  • Commit: 07e2053e12370e52cd1dc0bdad58c1613796316b
  • Workflows Created: 1

⏳ Status: The patch creation workflow has been triggered and is waiting for deployment approval. Please visit the specific workflow links below and approve the runs.

🔗 Track Progress:

github-actions bot pushed a commit that referenced this pull request Apr 1, 2026
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 1, 2026

🚀 [Step 2/4] Patch PR Created!

📋 Patch Details:

📝 Next Steps:

  1. ⚠️ Resolve conflicts in the hotfix PR first: #24426
  2. Test your changes after resolving conflicts
  3. Once merged, the patch release will automatically trigger
  4. You'll receive updates here when the release completes

🔗 Track Progress:

@jerop
Copy link
Copy Markdown
Contributor

jerop commented Apr 1, 2026

turns out preview release has not been cut yet, so just stopping this patch

kalenkevich pushed a commit to kalenkevich/gemini-cli that referenced this pull request Apr 3, 2026
afanty2021 pushed a commit to afanty2021/gemini-cli that referenced this pull request Apr 4, 2026
warrenzhu25 pushed a commit to warrenzhu25/gemini-cli that referenced this pull request Apr 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/core Issues related to User Interface, OS Support, Core Functionality 🔒 maintainer only ⛔ Do not contribute. Internal roadmap item.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Remove experimental feature flag for planning

2 participants