feat(forms): Add batch_update_form tool for Google Forms API

[ugoano]

Summary

• Adds batch_update_form MCP tool exposing the Google Forms batchUpdate API endpoint
• Supports all request types: createItem, updateItem, deleteItem, moveItem, updateFormInfo, updateSettings
• Includes _batch_update_form_impl internal function for testability (matching existing _impl pattern from Apps Script tools)
• Adds 6 unit tests following existing pytest + pytest-asyncio + Mock conventions

Motivation

The Forms module has create_form and get_form but no way to modify form content after creation. The Google Forms API supports batchUpdate natively — this PR exposes it through the MCP server, enabling users to programmatically add questions, update settings, and manage form structure.

Changes

File	Change
gforms/forms_tools.py	Added _batch_update_form_impl + batch_update_form (+95 lines)
tests/gforms/__init__.py	New test package init (empty, matching existing pattern)
tests/gforms/test_forms_tools.py	6 unit tests (+231 lines)

Design Decisions

• Slides-style pass-through pattern (not Docs-style abstraction) — the Forms module is flat with no managers/helpers, so raw API request pass-through is the consistent choice
• _impl pattern for testability — separates business logic from MCP decorators, matching gappsscript/apps_script_tools.py
• No refactoring of existing 5 Forms tools — keeps PR scope minimal

Test Plan

• 6 new unit tests all pass (pytest tests/gforms/test_forms_tools.py -v)
• All 18 existing Apps Script tests still pass (no regressions)
• ruff check passes with no issues
• No new dependencies added
• Existing decorator stack used: @server.tool() → @handle_http_errors → @require_google_service

[taylorwilsdon]

Thanks for the PR! You're missing the tool tiers entry and README docs, but seems like useful capability.

[ugoano]

Thanks for the review! This is Arno (Ugo's AI assistant) — I've added the tool tiers entry and README docs in b7a2f08. Let me know if anything else needs updating.

[Copilot]

Pull request overview

This PR adds batch update functionality to the Google Forms module by introducing a new batch_update_form tool that wraps the Google Forms API batchUpdate endpoint, enabling programmatic modification of form content after creation.

Changes:

• Added batch_update_form tool with internal _batch_update_form_impl function for testability
• Created comprehensive unit test suite with 6 test cases covering various batch update scenarios
• Updated documentation to reflect the new tool availability

Reviewed changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
gforms/forms_tools.py	Implements _batch_update_form_impl and batch_update_form tool supporting all Forms API batch update request types
tests/gforms/test_forms_tools.py	Adds 6 unit tests covering multiple requests, single requests, empty/missing replies, URL generation, and mixed reply types
core/tool_tiers.yaml	Registers batch_update_form in the "complete" tier for forms
README_NEW.md	Updates tool count from 5 to 6 and adds batch_update_form to the forms tools table
README.md	Adds batch_update_form entry to the forms tools table

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Corrected spelling of 'Favourite' to 'Favorite' to match American English spelling convention.

Suggested change

	"title": "Favourite colour?",
	"title": "Favorite color?",