feat: add pos parameter to move_card for list position control

[Schutzworks]

Closes #51
Adds an optional pos parameter to the move_card tool, allowing control over card position within the target list.
Changes:

Added pos to move_card input schema (accepts "top", "bottom", or numeric value)
Updated moveCard client method to include pos in the API request

Usage:
javascript// Move card to top of list
move_card({ cardId: "xxx", listId: "yyy", pos: "top" })

// Move card to specific position
move_card({ cardId: "xxx", listId: "yyy", pos: 140737487919104 })
Tested and working in Claude Desktop.

[gemini-code-assist]

Summary of Changes

Hello @Schutzworks, 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 introduces a significant enhancement to the card movement functionality by adding an optional position parameter. This allows users to specify where a card should be placed within a list, offering greater flexibility and control over board organization. The change involves updating both the tool's input definition and the client-side API call to accommodate this new parameter.

Highlights

• Enhanced Card Movement: The move_card tool now supports an optional pos parameter, allowing precise control over a card's position within its target list.
• Position Parameter Options: The new pos parameter accepts string values like 'top' or 'bottom', or a numeric value to specify an exact position.
• Schema and API Integration: The input schema for move_card has been updated to include pos, and the underlying Trello client method now passes this parameter to the Trello API.

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

[gemini-code-assist]

Code Review

This pull request adds a pos parameter to the move_card tool, which is a great feature for controlling card placement. The implementation correctly threads the new parameter through to the Trello API. My main feedback is to improve the input validation for the new pos parameter in the Zod schema to make it more strict, ensuring it only accepts valid values ("top", "bottom", or a positive number) as expected by the Trello API. This will prevent invalid data from being passed to the client and improve the tool's robustness.

[gemini-code-assist]

The current Zod schema for pos is z.union([z.string(), z.number()]), which is too permissive. It allows any string (not just "top" or "bottom") and any number (including negative numbers and zero), which could lead to unexpected behavior or API errors that are not caught by validation.

According to the Trello API documentation and the description you've provided, pos should be either "top", "bottom", or a positive number.

To enforce this and provide better type safety and validation, you should refine the schema. I suggest using z.enum(['top', 'bottom']) for the string part and z.number().positive() for the number part.

Suggested change

	pos: z
	.union([z.string(), z.number()])
	.optional()
	.describe('Position in target list: "top", "bottom", or a positive number'),
	pos: z
	.union([z.enum(['top', 'bottom']), z.number().positive()])
	.optional()
	.describe('Position in target list: "top", "bottom", or a positive number'),