Update sprint MCP tools for points, repo/project boards, needs_approval #32

Merged

forgejo_admin merged 1 commit from 11-update-sprint-mcp-tools-points-boards-column into main

2026-03-13 06:54:58 +00:00

forgejo_admin commented

2026-03-13 06:45:16 +00:00

Owner

Summary

Expose the points parameter on add_sprint_item and move_sprint_item, add repo and project as valid item types across all sprint tools, and add needs_approval as a valid column across all sprint tools.

Changes

src/pal_e_docs_mcp/tools/sprints.py:
- Added points parameter (optional int, Fibonacci: 1/2/3/5/8) to add_sprint_item and move_sprint_item
- Updated all item_type descriptions to include repo and project (6 boards total)
- Updated all column descriptions to include needs_approval (7 columns total)
- Updated docstrings on create_sprint, add_sprint_item, get_sprint_board, get_backlog, bulk_move_items to reflect expanded schema
- move_sprint_item now passes points to SDK using _UNSET sentinel for omitted values

Test Plan

Verify ruff check and ruff format --check pass (confirmed)
Verify Python syntax parses cleanly (confirmed)
Manually test add_sprint_item with points=3 on a sprint board
Manually test move_sprint_item with points=5 to update an item's points
Verify get_sprint_board with item_type='repo' and item_type='project'
Verify column needs_approval works in add_sprint_item, move_sprint_item, get_sprint_board

Review Checklist

No breaking changes to existing tool signatures (all new params are optional with defaults)
ruff check and ruff format pass
SDK already supports points in add_sprint_item and update_sprint_item
Sentinel _UNSET used correctly for points in move_sprint_item (omit vs clear)

Closes #11
Forgejo issue: #11

## Summary Expose the `points` parameter on `add_sprint_item` and `move_sprint_item`, add `repo` and `project` as valid item types across all sprint tools, and add `needs_approval` as a valid column across all sprint tools. ## Changes - `src/pal_e_docs_mcp/tools/sprints.py`: - Added `points` parameter (optional int, Fibonacci: 1/2/3/5/8) to `add_sprint_item` and `move_sprint_item` - Updated all `item_type` descriptions to include `repo` and `project` (6 boards total) - Updated all `column` descriptions to include `needs_approval` (7 columns total) - Updated docstrings on `create_sprint`, `add_sprint_item`, `get_sprint_board`, `get_backlog`, `bulk_move_items` to reflect expanded schema - `move_sprint_item` now passes `points` to SDK using `_UNSET` sentinel for omitted values ## Test Plan - Verify `ruff check` and `ruff format --check` pass (confirmed) - Verify Python syntax parses cleanly (confirmed) - Manually test `add_sprint_item` with `points=3` on a sprint board - Manually test `move_sprint_item` with `points=5` to update an item's points - Verify `get_sprint_board` with `item_type='repo'` and `item_type='project'` - Verify column `needs_approval` works in `add_sprint_item`, `move_sprint_item`, `get_sprint_board` ## Review Checklist - [x] No breaking changes to existing tool signatures (all new params are optional with defaults) - [x] `ruff check` and `ruff format` pass - [x] SDK already supports `points` in `add_sprint_item` and `update_sprint_item` - [x] Sentinel `_UNSET` used correctly for `points` in `move_sprint_item` (omit vs clear) ## Related - Closes #11 - Forgejo issue: #11

forgejo_admin added 1 commit

2026-03-13 06:45:16 +00:00

Update sprint MCP tools for points field, repo/project boards, and needs_approval column

ci/woodpecker/push/woodpecker Pipeline was successful

Details

ci/woodpecker/pr/woodpecker Pipeline was successful

Details

764971260e

Expose the points parameter (Fibonacci: 1/2/3/5/8) on add_sprint_item and
move_sprint_item. Update all item_type descriptions to include 'repo' and
'project' board types. Update all column descriptions to include
'needs_approval'. Update docstrings to reflect six boards and seven columns.

Closes #11

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>