fix(patch): cherry-pick aa98caf to release/v0.31.0-preview.0-pr-20465 to patch version v0.31.0-preview.0 and create version 0.31.0-preview.1

[gemini-cli-robot]

This PR automatically cherry-picks commit aa98caf to patch version v0.31.0-preview.0 in the preview release to create version 0.31.0-preview.1.

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! 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 cherry-picks a commit to update the "Plan Mode" functionality within the CLI, specifically enhancing its adaptive planning workflow. The changes aim to provide more nuanced guidance for users and the system itself, tailoring the planning process (research, consultation, and plan structure) to the complexity of the task at hand. This refinement improves the efficiency and effectiveness of the planning phase for various development scenarios.

Highlights

• Adaptive Planning Workflow Introduced: The "Plan Mode" now features an adaptive workflow that adjusts research depth, plan structure, and consultation levels based on task complexity (Simple, Standard, Complex).
• Tiered Consultation and Drafting: New guidelines specify different consultation requirements (e.g., direct drafting for simple tasks, detailed trade-offs for complex tasks) and plan structures for various task complexities.
• Streamlined Plan Mode Rules: The rules for when to enter Plan Mode and the general efficiency guidelines have been simplified and clarified in the system prompts.
• Documentation and Prompt Alignment: Both the user-facing documentation (plan-mode.md) and the internal system prompts (prompts.test.ts.snap, snippets.ts) have been updated to reflect the new adaptive planning workflow.

Changelog

• docs/cli/plan-mode.md
  • Updated the "Planning Workflow" section to describe an adaptive process based on task complexity.
  • Detailed different consultation levels and plan structures for simple, standard, and complex tasks.
• packages/core/src/core/snapshots/prompts.test.ts.snap
  • Updated snapshots to reflect changes in the Plan Mode prompt, including simplified language and the new adaptive workflow structure.
• packages/core/src/core/prompts.test.ts
  • Modified the test expectation for the core system prompt to align with the revised conditions for entering Plan Mode.
• packages/core/src/prompts/snippets.ts
  • Refactored the renderPlanningWorkflow function to incorporate the adaptive planning workflow.
  • Simplified the rules for Plan Mode, including conditions for read-only access, write constraints, efficiency, inquiries/directives, plan storage, and direct modification.
  • Updated the description of the Plan Mode goal from "detailed implementation plan" to "implementation plan".
  • Adjusted the workflowStepResearch function to reflect the new criteria for using enter_plan_mode.

Activity

• This pull request was automatically generated to cherry-pick commit aa98caf into the release/v0.31.0-preview.0-pr-20465 branch.
• The purpose is to patch version v0.31.0-preview.0 and create v0.31.0-preview.1.

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.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

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. ↩

[github-actions]

Size Change: -231 B (0%)

Total Size: 25.7 MB

ℹ️ View Unchanged

Filename	Size	Change
./bundle/gemini.js	25.2 MB	-231 B (0%)
./bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js	221 kB	0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js	227 kB	0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js	11.5 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

_{compressed-size-action}