Adding an initial draft of batch/bulk field-value writes

README.md

@@ -1101,6 +1101,7 @@ The following sets of tools are available:
   - `item_owner`: The owner (user or organization) of the repository containing the issue or pull request. Required for 'add_project_item' method. Also accepted by 'update_project_item' when resolving the item by issue number. (string, optional)
   - `item_repo`: The name of the repository containing the issue or pull request. Required for 'add_project_item' method. Also accepted by 'update_project_item' when resolving the item by issue number. (string, optional)
   - `item_type`: The item's type, either issue or pull_request. Required for 'add_project_item' method. (string, optional)
+  - `items`: The set of items to update. Required for 'update_project_items'. Each entry references either an existing item by 'item_id', or by (item_owner + item_repo + issue_number). Each entry may optionally include its own 'updated_field'; if omitted, the top-level 'updated_field' is applied. Limit: 100 items per call. (object[], optional)
   - `iteration_duration`: Duration in days for iterations of the field (e.g. 7 for weekly, 14 for bi-weekly). Required for 'create_iteration_field' method. (number, optional)
   - `iterations`: Custom iterations for 'create_iteration_field' method. Only set this when you need iterations with varying durations, breaks between them, or specific titles. Otherwise omit it: GitHub auto-creates three iterations of 'iteration_duration' days starting on 'start_date', which is the right choice for most cases. (object[], optional)
   - `method`: The method to execute (string, required)
@@ -1112,7 +1113,7 @@ The following sets of tools are available:
   - `status`: The status of the project. Used for 'create_project_status_update' method. (string, optional)
   - `target_date`: The target date of the status update in YYYY-MM-DD format. Used for 'create_project_status_update' method. (string, optional)
   - `title`: The project title. Required for 'create_project' method. (string, optional)
-  - `updated_field`: Object describing the field to update and its new value. Required for 'update_project_item'. Two shapes are accepted: (1) by ID — {"id": 123456, "value": "..."}; (2) by name — {"name": "Status", "value": "In Progress"}. For single-select fields, option-name resolution requires the by-name shape; on the by-ID shape, pass the option ID. Set value to null to clear the field. (object, optional)
+  - `updated_field`: Object describing the field to update and its new value. Required for 'update_project_item'. For 'update_project_item' provide either a single-item shape at the top level, or override per-item on 'update_project_items'. Two shapes are accepted: (1) by ID — {"id": 123456, "value": "..."}; (2) by name — {"name": "Status", "value": "In Progress"}. For single-select fields, option-name resolution requires the by-name shape; on the by-ID shape, pass the option ID. Set value to null to clear the field. For 'update_project_items', a top-level 'updated_field' is applied to every item that does not supply its own 'updated_field'. (object, optional)
 
 </details>
 

pkg/github/__toolsnaps__/projects_write.snap

@@ -40,6 +40,36 @@
         ],
         "type": "string"
       },
+      "items": {
+        "description": "The set of items to update. Required for 'update_project_items'. Each entry references either an existing item by 'item_id', or by (item_owner + item_repo + issue_number). Each entry may optionally include its own 'updated_field'; if omitted, the top-level 'updated_field' is applied. Limit: 100 items per call.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "issue_number": {
+              "description": "Issue number (or pull request number) used to resolve the project item together with item_owner and item_repo.",
+              "type": "number"
+            },
+            "item_id": {
+              "description": "The project item ID. Provide either item_id, or (item_owner + item_repo + issue_number).",
+              "type": "number"
+            },
+            "item_owner": {
+              "description": "Owner of the repository containing the issue or pull request. Combine with item_repo and issue_number to resolve the item.",
+              "type": "string"
+            },
+            "item_repo": {
+              "description": "Repository containing the issue or pull request. Combine with item_owner and issue_number to resolve the item.",
+              "type": "string"
+            },
+            "updated_field": {
+              "description": "Per-item field update. Overrides the top-level 'updated_field'. Same shape as the top-level 'updated_field'.",
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
       "iteration_duration": {
         "description": "Duration in days for iterations of the field (e.g. 7 for weekly, 14 for bi-weekly). Required for 'create_iteration_field' method.",
         "type": "number"
@@ -76,6 +106,7 @@
         "enum": [
           "add_project_item",
           "update_project_item",
+          "update_project_items",
           "delete_project_item",
           "create_project_status_update",
           "create_project",
@@ -127,7 +158,7 @@
         "type": "string"
       },
       "updated_field": {
-        "description": "Object describing the field to update and its new value. Required for 'update_project_item'. Two shapes are accepted: (1) by ID — {\"id\": 123456, \"value\": \"...\"}; (2) by name — {\"name\": \"Status\", \"value\": \"In Progress\"}. For single-select fields, option-name resolution requires the by-name shape; on the by-ID shape, pass the option ID. Set value to null to clear the field.",
+        "description": "Object describing the field to update and its new value. Required for 'update_project_item'. For 'update_project_item' provide either a single-item shape at the top level, or override per-item on 'update_project_items'. Two shapes are accepted: (1) by ID — {\"id\": 123456, \"value\": \"...\"}; (2) by name — {\"name\": \"Status\", \"value\": \"In Progress\"}. For single-select fields, option-name resolution requires the by-name shape; on the by-ID shape, pass the option ID. Set value to null to clear the field. For 'update_project_items', a top-level 'updated_field' is applied to every item that does not supply its own 'updated_field'.",
         "type": "object"
       }
     },