From 1ad8e28286b57e9b554fb6d6df3156ae7be3ad66 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Sun, 28 Dec 2025 05:02:20 +0000 Subject: [PATCH 1/3] Initial plan From 44be1f562fbb82beb172f7ba437cff4077ba8c5c Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Sun, 28 Dec 2025 05:14:22 +0000 Subject: [PATCH 2/3] Enhance MCP tool schema documentation with parameter examples - Updated all number parameters (item_number, issue_number, pull_request_number, discussion_number, etc.) to include clear examples showing the numeric ID format from GitHub URLs - Enhanced add_comment.item_number with explicit description that it's the numeric ID from GitHub URL (e.g., 123 in github.com/owner/repo/issues/123) - Applied same enhancement pattern to 18 other MCP safe output tools - Synced changes between actions/setup/js and pkg/workflow/js directories - Verified schema changes are embedded in the binary via build process Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com> --- actions/setup/js/safe_outputs_tools.json | 36 ++++++++++++------------ pkg/workflow/js/safe_outputs_tools.json | 36 ++++++++++++------------ 2 files changed, 36 insertions(+), 36 deletions(-) diff --git a/actions/setup/js/safe_outputs_tools.json b/actions/setup/js/safe_outputs_tools.json index 1fd7cfbc2e3..a14e27adfdf 100644 --- a/actions/setup/js/safe_outputs_tools.json +++ b/actions/setup/js/safe_outputs_tools.json @@ -23,7 +23,7 @@ }, "parent": { "type": ["number", "string"], - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run." + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run." }, "temporary_id": { "type": "string", @@ -87,7 +87,7 @@ }, "discussion_number": { "type": ["number", "string"], - "description": "Discussion number to update. Required when the workflow target is '*' (any discussion)." + "description": "Discussion number to update. This is the numeric ID from the GitHub URL (e.g., 345 in github.com/owner/repo/discussions/345). Required when the workflow target is '*' (any discussion)." } }, "additionalProperties": false @@ -111,7 +111,7 @@ }, "discussion_number": { "type": ["number", "string"], - "description": "Discussion number to close. If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger)." + "description": "Discussion number to close. This is the numeric ID from the GitHub URL (e.g., 678 in github.com/owner/repo/discussions/678). If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger)." } }, "additionalProperties": false @@ -130,7 +130,7 @@ }, "issue_number": { "type": ["number", "string"], - "description": "Issue number to close. If omitted, closes the issue that triggered this workflow (requires an issue event trigger)." + "description": "Issue number to close. This is the numeric ID from the GitHub URL (e.g., 901 in github.com/owner/repo/issues/901). If omitted, closes the issue that triggered this workflow (requires an issue event trigger)." } }, "additionalProperties": false @@ -149,7 +149,7 @@ }, "pull_request_number": { "type": ["number", "string"], - "description": "Pull request number to close. If omitted, closes the PR that triggered this workflow (requires a pull_request event trigger)." + "description": "Pull request number to close. This is the numeric ID from the GitHub URL (e.g., 432 in github.com/owner/repo/pull/432). If omitted, closes the PR that triggered this workflow (requires a pull_request event trigger)." } }, "additionalProperties": false @@ -168,7 +168,7 @@ }, "item_number": { "type": "number", - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository." + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required." } }, "additionalProperties": false @@ -288,7 +288,7 @@ }, "item_number": { "type": "number", - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow." + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow." } }, "additionalProperties": false @@ -310,7 +310,7 @@ }, "pull_request_number": { "type": ["number", "string"], - "description": "Pull request number to add reviewers to. If omitted, adds reviewers to the PR that triggered this workflow." + "description": "Pull request number to add reviewers to. This is the numeric ID from the GitHub URL (e.g., 876 in github.com/owner/repo/pull/876). If omitted, adds reviewers to the PR that triggered this workflow." } }, "additionalProperties": false @@ -325,11 +325,11 @@ "properties": { "issue_number": { "type": ["number", "string"], - "description": "Issue number to assign to the milestone." + "description": "Issue number to assign to the milestone. This is the numeric ID from the GitHub URL (e.g., 567 in github.com/owner/repo/issues/567)." }, "milestone_number": { "type": ["number", "string"], - "description": "Milestone number (not title) to assign the issue to. Find milestone numbers in the repository's Milestones page." + "description": "Milestone number (not title) to assign the issue to. This is the numeric ID from the milestone URL (e.g., 12 in github.com/owner/repo/milestone/12). Find milestone numbers in the repository's Milestones page." } }, "additionalProperties": false @@ -344,7 +344,7 @@ "properties": { "issue_number": { "type": ["number", "string"], - "description": "Issue number to assign the Copilot agent to. The issue should contain clear, actionable requirements." + "description": "Issue number to assign the Copilot agent to. This is the numeric ID from the GitHub URL (e.g., 234 in github.com/owner/repo/issues/234). The issue should contain clear, actionable requirements." }, "agent": { "type": "string", @@ -363,7 +363,7 @@ "properties": { "issue_number": { "type": ["number", "string"], - "description": "Issue number to assign users to. If omitted, assigns to the issue that triggered this workflow." + "description": "Issue number to assign users to. This is the numeric ID from the GitHub URL (e.g., 543 in github.com/owner/repo/issues/543). If omitted, assigns to the issue that triggered this workflow." }, "assignees": { "type": "array", @@ -401,7 +401,7 @@ }, "issue_number": { "type": ["number", "string"], - "description": "Issue number to update. Required when the workflow target is '*' (any issue)." + "description": "Issue number to update. This is the numeric ID from the GitHub URL (e.g., 789 in github.com/owner/repo/issues/789). Required when the workflow target is '*' (any issue)." } }, "additionalProperties": false @@ -428,7 +428,7 @@ }, "pull_request_number": { "type": ["number", "string"], - "description": "Pull request number to update. Required when the workflow target is '*' (any PR)." + "description": "Pull request number to update. This is the numeric ID from the GitHub URL (e.g., 234 in github.com/owner/repo/pull/234). Required when the workflow target is '*' (any PR)." } }, "additionalProperties": false @@ -451,7 +451,7 @@ }, "pull_request_number": { "type": ["number", "string"], - "description": "Pull request number to push changes to. Required when the workflow target is '*' (any PR)." + "description": "Pull request number to push changes to. This is the numeric ID from the GitHub URL (e.g., 654 in github.com/owner/repo/pull/654). Required when the workflow target is '*' (any PR)." } }, "additionalProperties": false @@ -543,11 +543,11 @@ "properties": { "parent_issue_number": { "type": ["number", "string"], - "description": "The parent issue number to link the sub-issue to." + "description": "The parent issue number to link the sub-issue to. This is the numeric ID from the GitHub URL (e.g., 100 in github.com/owner/repo/issues/100)." }, "sub_issue_number": { "type": ["number", "string"], - "description": "The issue number to link as a sub-issue of the parent." + "description": "The issue number to link as a sub-issue of the parent. This is the numeric ID from the GitHub URL (e.g., 101 in github.com/owner/repo/issues/101)." } }, "additionalProperties": false @@ -591,7 +591,7 @@ }, "content_number": { "type": "number", - "description": "Issue or pull request number to add to the project (e.g., 123 for issue #123). Required when content_type is 'issue' or 'pull_request'." + "description": "Issue or pull request number to add to the project. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123 for issue #123, or 456 in github.com/owner/repo/pull/456 for PR #456). Required when content_type is 'issue' or 'pull_request'." }, "draft_title": { "type": "string", diff --git a/pkg/workflow/js/safe_outputs_tools.json b/pkg/workflow/js/safe_outputs_tools.json index 1fd7cfbc2e3..a14e27adfdf 100644 --- a/pkg/workflow/js/safe_outputs_tools.json +++ b/pkg/workflow/js/safe_outputs_tools.json @@ -23,7 +23,7 @@ }, "parent": { "type": ["number", "string"], - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run." + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run." }, "temporary_id": { "type": "string", @@ -87,7 +87,7 @@ }, "discussion_number": { "type": ["number", "string"], - "description": "Discussion number to update. Required when the workflow target is '*' (any discussion)." + "description": "Discussion number to update. This is the numeric ID from the GitHub URL (e.g., 345 in github.com/owner/repo/discussions/345). Required when the workflow target is '*' (any discussion)." } }, "additionalProperties": false @@ -111,7 +111,7 @@ }, "discussion_number": { "type": ["number", "string"], - "description": "Discussion number to close. If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger)." + "description": "Discussion number to close. This is the numeric ID from the GitHub URL (e.g., 678 in github.com/owner/repo/discussions/678). If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger)." } }, "additionalProperties": false @@ -130,7 +130,7 @@ }, "issue_number": { "type": ["number", "string"], - "description": "Issue number to close. If omitted, closes the issue that triggered this workflow (requires an issue event trigger)." + "description": "Issue number to close. This is the numeric ID from the GitHub URL (e.g., 901 in github.com/owner/repo/issues/901). If omitted, closes the issue that triggered this workflow (requires an issue event trigger)." } }, "additionalProperties": false @@ -149,7 +149,7 @@ }, "pull_request_number": { "type": ["number", "string"], - "description": "Pull request number to close. If omitted, closes the PR that triggered this workflow (requires a pull_request event trigger)." + "description": "Pull request number to close. This is the numeric ID from the GitHub URL (e.g., 432 in github.com/owner/repo/pull/432). If omitted, closes the PR that triggered this workflow (requires a pull_request event trigger)." } }, "additionalProperties": false @@ -168,7 +168,7 @@ }, "item_number": { "type": "number", - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository." + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required." } }, "additionalProperties": false @@ -288,7 +288,7 @@ }, "item_number": { "type": "number", - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow." + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow." } }, "additionalProperties": false @@ -310,7 +310,7 @@ }, "pull_request_number": { "type": ["number", "string"], - "description": "Pull request number to add reviewers to. If omitted, adds reviewers to the PR that triggered this workflow." + "description": "Pull request number to add reviewers to. This is the numeric ID from the GitHub URL (e.g., 876 in github.com/owner/repo/pull/876). If omitted, adds reviewers to the PR that triggered this workflow." } }, "additionalProperties": false @@ -325,11 +325,11 @@ "properties": { "issue_number": { "type": ["number", "string"], - "description": "Issue number to assign to the milestone." + "description": "Issue number to assign to the milestone. This is the numeric ID from the GitHub URL (e.g., 567 in github.com/owner/repo/issues/567)." }, "milestone_number": { "type": ["number", "string"], - "description": "Milestone number (not title) to assign the issue to. Find milestone numbers in the repository's Milestones page." + "description": "Milestone number (not title) to assign the issue to. This is the numeric ID from the milestone URL (e.g., 12 in github.com/owner/repo/milestone/12). Find milestone numbers in the repository's Milestones page." } }, "additionalProperties": false @@ -344,7 +344,7 @@ "properties": { "issue_number": { "type": ["number", "string"], - "description": "Issue number to assign the Copilot agent to. The issue should contain clear, actionable requirements." + "description": "Issue number to assign the Copilot agent to. This is the numeric ID from the GitHub URL (e.g., 234 in github.com/owner/repo/issues/234). The issue should contain clear, actionable requirements." }, "agent": { "type": "string", @@ -363,7 +363,7 @@ "properties": { "issue_number": { "type": ["number", "string"], - "description": "Issue number to assign users to. If omitted, assigns to the issue that triggered this workflow." + "description": "Issue number to assign users to. This is the numeric ID from the GitHub URL (e.g., 543 in github.com/owner/repo/issues/543). If omitted, assigns to the issue that triggered this workflow." }, "assignees": { "type": "array", @@ -401,7 +401,7 @@ }, "issue_number": { "type": ["number", "string"], - "description": "Issue number to update. Required when the workflow target is '*' (any issue)." + "description": "Issue number to update. This is the numeric ID from the GitHub URL (e.g., 789 in github.com/owner/repo/issues/789). Required when the workflow target is '*' (any issue)." } }, "additionalProperties": false @@ -428,7 +428,7 @@ }, "pull_request_number": { "type": ["number", "string"], - "description": "Pull request number to update. Required when the workflow target is '*' (any PR)." + "description": "Pull request number to update. This is the numeric ID from the GitHub URL (e.g., 234 in github.com/owner/repo/pull/234). Required when the workflow target is '*' (any PR)." } }, "additionalProperties": false @@ -451,7 +451,7 @@ }, "pull_request_number": { "type": ["number", "string"], - "description": "Pull request number to push changes to. Required when the workflow target is '*' (any PR)." + "description": "Pull request number to push changes to. This is the numeric ID from the GitHub URL (e.g., 654 in github.com/owner/repo/pull/654). Required when the workflow target is '*' (any PR)." } }, "additionalProperties": false @@ -543,11 +543,11 @@ "properties": { "parent_issue_number": { "type": ["number", "string"], - "description": "The parent issue number to link the sub-issue to." + "description": "The parent issue number to link the sub-issue to. This is the numeric ID from the GitHub URL (e.g., 100 in github.com/owner/repo/issues/100)." }, "sub_issue_number": { "type": ["number", "string"], - "description": "The issue number to link as a sub-issue of the parent." + "description": "The issue number to link as a sub-issue of the parent. This is the numeric ID from the GitHub URL (e.g., 101 in github.com/owner/repo/issues/101)." } }, "additionalProperties": false @@ -591,7 +591,7 @@ }, "content_number": { "type": "number", - "description": "Issue or pull request number to add to the project (e.g., 123 for issue #123). Required when content_type is 'issue' or 'pull_request'." + "description": "Issue or pull request number to add to the project. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123 for issue #123, or 456 in github.com/owner/repo/pull/456 for PR #456). Required when content_type is 'issue' or 'pull_request'." }, "draft_title": { "type": "string", From 3cc9c7c25c499415f556cbc8366324fcb7b57cf5 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Sun, 28 Dec 2025 05:17:40 +0000 Subject: [PATCH 3/3] Complete: MCP tool schema documentation enhancements validated Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com> --- .../agent-performance-analyzer.lock.yml | 4 ++-- .github/workflows/ai-moderator.lock.yml | 2 +- .github/workflows/archie.lock.yml | 2 +- .github/workflows/brave.lock.yml | 2 +- .../workflows/breaking-change-checker.lock.yml | 2 +- .github/workflows/campaign-generator.lock.yml | 4 ++-- .github/workflows/campaign-manager.lock.yml | 6 +++--- .github/workflows/changeset.lock.yml | 4 ++-- .github/workflows/ci-doctor.lock.yml | 4 ++-- .../workflows/cli-consistency-checker.lock.yml | 2 +- .github/workflows/cli-version-checker.lock.yml | 2 +- .github/workflows/cloclo.lock.yml | 2 +- .github/workflows/close-old-discussions.lock.yml | 2 +- .github/workflows/craft.lock.yml | 4 ++-- .../daily-assign-issue-to-user.lock.yml | 4 ++-- .github/workflows/daily-fact.lock.yml | 2 +- .github/workflows/daily-file-diet.lock.yml | 2 +- .github/workflows/daily-issues-report.lock.yml | 2 +- .../daily-multi-device-docs-tester.lock.yml | 2 +- .../workflows/daily-performance-summary.lock.yml | 2 +- .github/workflows/dependabot-go-checker.lock.yml | 4 ++-- .github/workflows/dev-hawk.lock.yml | 2 +- .github/workflows/dev.lock.yml | 2 +- .../workflows/duplicate-code-detector.lock.yml | 2 +- ...-size-reduction-project64.campaign.g.lock.yml | 4 ++-- .github/workflows/go-pattern-detector.lock.yml | 2 +- .github/workflows/grumpy-reviewer.lock.yml | 2 +- .../workflows/human-ai-collaboration.lock.yml | 2 +- .github/workflows/incident-response.lock.yml | 6 +++--- .github/workflows/intelligence.lock.yml | 2 +- .github/workflows/issue-arborist.lock.yml | 6 +++--- .github/workflows/issue-classifier.lock.yml | 2 +- .github/workflows/issue-monster.lock.yml | 4 ++-- .github/workflows/issue-triage-agent.lock.yml | 4 ++-- .github/workflows/mergefest.lock.yml | 2 +- .github/workflows/org-wide-rollout.lock.yml | 6 +++--- .github/workflows/pdf-summary.lock.yml | 2 +- .github/workflows/plan.lock.yml | 4 ++-- .../playground-org-project-update-issue.lock.yml | 2 +- .github/workflows/poem-bot.lock.yml | 16 ++++++++-------- .github/workflows/pr-nitpick-reviewer.lock.yml | 2 +- .github/workflows/q.lock.yml | 2 +- .github/workflows/scout.lock.yml | 2 +- .github/workflows/security-compliance.lock.yml | 2 +- .../semantic-function-refactor.lock.yml | 4 ++-- .github/workflows/smoke-claude.lock.yml | 6 +++--- .github/workflows/smoke-codex-firewall.lock.yml | 6 +++--- .github/workflows/smoke-codex.lock.yml | 6 +++--- .../workflows/smoke-copilot-no-firewall.lock.yml | 4 ++-- .../workflows/smoke-copilot-playwright.lock.yml | 6 +++--- .../workflows/smoke-copilot-safe-inputs.lock.yml | 4 ++-- .github/workflows/smoke-copilot.lock.yml | 6 +++--- .github/workflows/smoke-detector.lock.yml | 4 ++-- .github/workflows/speckit-dispatcher.lock.yml | 8 ++++---- .github/workflows/stale-repo-identifier.lock.yml | 2 +- .github/workflows/sub-issue-closer.lock.yml | 4 ++-- .github/workflows/super-linter.lock.yml | 2 +- .github/workflows/technical-doc-writer.lock.yml | 2 +- .github/workflows/tidy.lock.yml | 2 +- .github/workflows/unbloat-docs.lock.yml | 2 +- .github/workflows/video-analyzer.lock.yml | 2 +- .github/workflows/workflow-generator.lock.yml | 4 ++-- .../workflows/workflow-health-manager.lock.yml | 6 +++--- 63 files changed, 110 insertions(+), 110 deletions(-) diff --git a/.github/workflows/agent-performance-analyzer.lock.yml b/.github/workflows/agent-performance-analyzer.lock.yml index b7cc69ec40f..13dbae53130 100644 --- a/.github/workflows/agent-performance-analyzer.lock.yml +++ b/.github/workflows/agent-performance-analyzer.lock.yml @@ -272,7 +272,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -331,7 +331,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/ai-moderator.lock.yml b/.github/workflows/ai-moderator.lock.yml index 89cf4b16576..a653694b82d 100644 --- a/.github/workflows/ai-moderator.lock.yml +++ b/.github/workflows/ai-moderator.lock.yml @@ -236,7 +236,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/archie.lock.yml b/.github/workflows/archie.lock.yml index f49672e1761..614a9484660 100644 --- a/.github/workflows/archie.lock.yml +++ b/.github/workflows/archie.lock.yml @@ -276,7 +276,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/brave.lock.yml b/.github/workflows/brave.lock.yml index bdbc178a5c5..3bfd14577a6 100644 --- a/.github/workflows/brave.lock.yml +++ b/.github/workflows/brave.lock.yml @@ -256,7 +256,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/breaking-change-checker.lock.yml b/.github/workflows/breaking-change-checker.lock.yml index c96b93d457c..8994ac2c7b3 100644 --- a/.github/workflows/breaking-change-checker.lock.yml +++ b/.github/workflows/breaking-change-checker.lock.yml @@ -227,7 +227,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/campaign-generator.lock.yml b/.github/workflows/campaign-generator.lock.yml index 9d982ecada4..debbf48838b 100644 --- a/.github/workflows/campaign-generator.lock.yml +++ b/.github/workflows/campaign-generator.lock.yml @@ -232,7 +232,7 @@ jobs: "type": "string" }, "issue_number": { - "description": "Issue number to assign the Copilot agent to. The issue should contain clear, actionable requirements.", + "description": "Issue number to assign the Copilot agent to. This is the numeric ID from the GitHub URL (e.g., 234 in github.com/owner/repo/issues/234). The issue should contain clear, actionable requirements.", "type": [ "number", "string" @@ -256,7 +256,7 @@ jobs: "type": "string" }, "issue_number": { - "description": "Issue number to update. Required when the workflow target is '*' (any issue).", + "description": "Issue number to update. This is the numeric ID from the GitHub URL (e.g., 789 in github.com/owner/repo/issues/789). Required when the workflow target is '*' (any issue).", "type": [ "number", "string" diff --git a/.github/workflows/campaign-manager.lock.yml b/.github/workflows/campaign-manager.lock.yml index d12e2f571f7..96d5ab1bdb1 100644 --- a/.github/workflows/campaign-manager.lock.yml +++ b/.github/workflows/campaign-manager.lock.yml @@ -228,7 +228,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -287,7 +287,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -381,7 +381,7 @@ jobs: "type": "string" }, "content_number": { - "description": "Issue or pull request number to add to the project (e.g., 123 for issue #123). Required when content_type is 'issue' or 'pull_request'.", + "description": "Issue or pull request number to add to the project. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123 for issue #123, or 456 in github.com/owner/repo/pull/456 for PR #456). Required when content_type is 'issue' or 'pull_request'.", "type": "number" }, "content_type": { diff --git a/.github/workflows/changeset.lock.yml b/.github/workflows/changeset.lock.yml index e2b15a19095..e860551b885 100644 --- a/.github/workflows/changeset.lock.yml +++ b/.github/workflows/changeset.lock.yml @@ -270,7 +270,7 @@ jobs: "type": "string" }, "pull_request_number": { - "description": "Pull request number to update. Required when the workflow target is '*' (any PR).", + "description": "Pull request number to update. This is the numeric ID from the GitHub URL (e.g., 234 in github.com/owner/repo/pull/234). Required when the workflow target is '*' (any PR).", "type": [ "number", "string" @@ -299,7 +299,7 @@ jobs: "type": "string" }, "pull_request_number": { - "description": "Pull request number to push changes to. Required when the workflow target is '*' (any PR).", + "description": "Pull request number to push changes to. This is the numeric ID from the GitHub URL (e.g., 654 in github.com/owner/repo/pull/654). Required when the workflow target is '*' (any PR).", "type": [ "number", "string" diff --git a/.github/workflows/ci-doctor.lock.yml b/.github/workflows/ci-doctor.lock.yml index af0af15c4d0..3e4e78df07f 100644 --- a/.github/workflows/ci-doctor.lock.yml +++ b/.github/workflows/ci-doctor.lock.yml @@ -254,7 +254,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -287,7 +287,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/cli-consistency-checker.lock.yml b/.github/workflows/cli-consistency-checker.lock.yml index 8af988096bb..a7f313a4489 100644 --- a/.github/workflows/cli-consistency-checker.lock.yml +++ b/.github/workflows/cli-consistency-checker.lock.yml @@ -227,7 +227,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/cli-version-checker.lock.yml b/.github/workflows/cli-version-checker.lock.yml index 2ef756b5ac6..b3c77946e87 100644 --- a/.github/workflows/cli-version-checker.lock.yml +++ b/.github/workflows/cli-version-checker.lock.yml @@ -241,7 +241,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/cloclo.lock.yml b/.github/workflows/cloclo.lock.yml index 09ba1fe8708..b79bbf5af50 100644 --- a/.github/workflows/cloclo.lock.yml +++ b/.github/workflows/cloclo.lock.yml @@ -326,7 +326,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/close-old-discussions.lock.yml b/.github/workflows/close-old-discussions.lock.yml index d5e2ea5b57d..7911d5a618f 100644 --- a/.github/workflows/close-old-discussions.lock.yml +++ b/.github/workflows/close-old-discussions.lock.yml @@ -248,7 +248,7 @@ jobs: "type": "string" }, "discussion_number": { - "description": "Discussion number to close. If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger).", + "description": "Discussion number to close. This is the numeric ID from the GitHub URL (e.g., 678 in github.com/owner/repo/discussions/678). If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger).", "type": [ "number", "string" diff --git a/.github/workflows/craft.lock.yml b/.github/workflows/craft.lock.yml index 0a1cf9db223..15fdf775621 100644 --- a/.github/workflows/craft.lock.yml +++ b/.github/workflows/craft.lock.yml @@ -256,7 +256,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -282,7 +282,7 @@ jobs: "type": "string" }, "pull_request_number": { - "description": "Pull request number to push changes to. Required when the workflow target is '*' (any PR).", + "description": "Pull request number to push changes to. This is the numeric ID from the GitHub URL (e.g., 654 in github.com/owner/repo/pull/654). Required when the workflow target is '*' (any PR).", "type": [ "number", "string" diff --git a/.github/workflows/daily-assign-issue-to-user.lock.yml b/.github/workflows/daily-assign-issue-to-user.lock.yml index 5161bb86737..a1d8afd26be 100644 --- a/.github/workflows/daily-assign-issue-to-user.lock.yml +++ b/.github/workflows/daily-assign-issue-to-user.lock.yml @@ -218,7 +218,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -247,7 +247,7 @@ jobs: "type": "array" }, "issue_number": { - "description": "Issue number to assign users to. If omitted, assigns to the issue that triggered this workflow.", + "description": "Issue number to assign users to. This is the numeric ID from the GitHub URL (e.g., 543 in github.com/owner/repo/issues/543). If omitted, assigns to the issue that triggered this workflow.", "type": [ "number", "string" diff --git a/.github/workflows/daily-fact.lock.yml b/.github/workflows/daily-fact.lock.yml index dc027771f47..4b2ed8d6d30 100644 --- a/.github/workflows/daily-fact.lock.yml +++ b/.github/workflows/daily-fact.lock.yml @@ -205,7 +205,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/daily-file-diet.lock.yml b/.github/workflows/daily-file-diet.lock.yml index 41f1d49f407..5cd4879658a 100644 --- a/.github/workflows/daily-file-diet.lock.yml +++ b/.github/workflows/daily-file-diet.lock.yml @@ -313,7 +313,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/daily-issues-report.lock.yml b/.github/workflows/daily-issues-report.lock.yml index f1af94c584c..d5b0e78c74a 100644 --- a/.github/workflows/daily-issues-report.lock.yml +++ b/.github/workflows/daily-issues-report.lock.yml @@ -298,7 +298,7 @@ jobs: "type": "string" }, "discussion_number": { - "description": "Discussion number to close. If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger).", + "description": "Discussion number to close. This is the numeric ID from the GitHub URL (e.g., 678 in github.com/owner/repo/discussions/678). If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger).", "type": [ "number", "string" diff --git a/.github/workflows/daily-multi-device-docs-tester.lock.yml b/.github/workflows/daily-multi-device-docs-tester.lock.yml index 2909739a3a1..b14525a268f 100644 --- a/.github/workflows/daily-multi-device-docs-tester.lock.yml +++ b/.github/workflows/daily-multi-device-docs-tester.lock.yml @@ -232,7 +232,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/daily-performance-summary.lock.yml b/.github/workflows/daily-performance-summary.lock.yml index ac90b3d2b1a..e1567d8fdfe 100644 --- a/.github/workflows/daily-performance-summary.lock.yml +++ b/.github/workflows/daily-performance-summary.lock.yml @@ -288,7 +288,7 @@ jobs: "type": "string" }, "discussion_number": { - "description": "Discussion number to close. If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger).", + "description": "Discussion number to close. This is the numeric ID from the GitHub URL (e.g., 678 in github.com/owner/repo/discussions/678). If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger).", "type": [ "number", "string" diff --git a/.github/workflows/dependabot-go-checker.lock.yml b/.github/workflows/dependabot-go-checker.lock.yml index 086b7d853f6..95676bfa2ac 100644 --- a/.github/workflows/dependabot-go-checker.lock.yml +++ b/.github/workflows/dependabot-go-checker.lock.yml @@ -228,7 +228,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -261,7 +261,7 @@ jobs: "type": "string" }, "issue_number": { - "description": "Issue number to close. If omitted, closes the issue that triggered this workflow (requires an issue event trigger).", + "description": "Issue number to close. This is the numeric ID from the GitHub URL (e.g., 901 in github.com/owner/repo/issues/901). If omitted, closes the issue that triggered this workflow (requires an issue event trigger).", "type": [ "number", "string" diff --git a/.github/workflows/dev-hawk.lock.yml b/.github/workflows/dev-hawk.lock.yml index f89cac2a81e..1c31686f905 100644 --- a/.github/workflows/dev-hawk.lock.yml +++ b/.github/workflows/dev-hawk.lock.yml @@ -249,7 +249,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/dev.lock.yml b/.github/workflows/dev.lock.yml index 843a6f0eefc..f3e30d3b59c 100644 --- a/.github/workflows/dev.lock.yml +++ b/.github/workflows/dev.lock.yml @@ -220,7 +220,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/duplicate-code-detector.lock.yml b/.github/workflows/duplicate-code-detector.lock.yml index 9c48cbacc1e..fb3f16c4307 100644 --- a/.github/workflows/duplicate-code-detector.lock.yml +++ b/.github/workflows/duplicate-code-detector.lock.yml @@ -235,7 +235,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/go-file-size-reduction-project64.campaign.g.lock.yml b/.github/workflows/go-file-size-reduction-project64.campaign.g.lock.yml index 449415ba3ac..9904b4e0c36 100644 --- a/.github/workflows/go-file-size-reduction-project64.campaign.g.lock.yml +++ b/.github/workflows/go-file-size-reduction-project64.campaign.g.lock.yml @@ -219,7 +219,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -313,7 +313,7 @@ jobs: "type": "string" }, "content_number": { - "description": "Issue or pull request number to add to the project (e.g., 123 for issue #123). Required when content_type is 'issue' or 'pull_request'.", + "description": "Issue or pull request number to add to the project. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123 for issue #123, or 456 in github.com/owner/repo/pull/456 for PR #456). Required when content_type is 'issue' or 'pull_request'.", "type": "number" }, "content_type": { diff --git a/.github/workflows/go-pattern-detector.lock.yml b/.github/workflows/go-pattern-detector.lock.yml index d4695bcd986..d82ec207dc9 100644 --- a/.github/workflows/go-pattern-detector.lock.yml +++ b/.github/workflows/go-pattern-detector.lock.yml @@ -230,7 +230,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/grumpy-reviewer.lock.yml b/.github/workflows/grumpy-reviewer.lock.yml index 20b360efbd9..3c907b283ee 100644 --- a/.github/workflows/grumpy-reviewer.lock.yml +++ b/.github/workflows/grumpy-reviewer.lock.yml @@ -266,7 +266,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/human-ai-collaboration.lock.yml b/.github/workflows/human-ai-collaboration.lock.yml index 37e56852305..8ebe8aec322 100644 --- a/.github/workflows/human-ai-collaboration.lock.yml +++ b/.github/workflows/human-ai-collaboration.lock.yml @@ -256,7 +256,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/incident-response.lock.yml b/.github/workflows/incident-response.lock.yml index efbfe8180af..7025b4edc38 100644 --- a/.github/workflows/incident-response.lock.yml +++ b/.github/workflows/incident-response.lock.yml @@ -270,7 +270,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -303,7 +303,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -354,7 +354,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/intelligence.lock.yml b/.github/workflows/intelligence.lock.yml index e6368dae3fa..f3f16488348 100644 --- a/.github/workflows/intelligence.lock.yml +++ b/.github/workflows/intelligence.lock.yml @@ -306,7 +306,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/issue-arborist.lock.yml b/.github/workflows/issue-arborist.lock.yml index 1ebfa697c79..81dd5743dde 100644 --- a/.github/workflows/issue-arborist.lock.yml +++ b/.github/workflows/issue-arborist.lock.yml @@ -234,7 +234,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -332,14 +332,14 @@ jobs: "additionalProperties": false, "properties": { "parent_issue_number": { - "description": "The parent issue number to link the sub-issue to.", + "description": "The parent issue number to link the sub-issue to. This is the numeric ID from the GitHub URL (e.g., 100 in github.com/owner/repo/issues/100).", "type": [ "number", "string" ] }, "sub_issue_number": { - "description": "The issue number to link as a sub-issue of the parent.", + "description": "The issue number to link as a sub-issue of the parent. This is the numeric ID from the GitHub URL (e.g., 101 in github.com/owner/repo/issues/101).", "type": [ "number", "string" diff --git a/.github/workflows/issue-classifier.lock.yml b/.github/workflows/issue-classifier.lock.yml index 793363c428a..2e230ebc413 100644 --- a/.github/workflows/issue-classifier.lock.yml +++ b/.github/workflows/issue-classifier.lock.yml @@ -201,7 +201,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/issue-monster.lock.yml b/.github/workflows/issue-monster.lock.yml index 61bb8581944..a2d389ccfb3 100644 --- a/.github/workflows/issue-monster.lock.yml +++ b/.github/workflows/issue-monster.lock.yml @@ -228,7 +228,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -250,7 +250,7 @@ jobs: "type": "string" }, "issue_number": { - "description": "Issue number to assign the Copilot agent to. The issue should contain clear, actionable requirements.", + "description": "Issue number to assign the Copilot agent to. This is the numeric ID from the GitHub URL (e.g., 234 in github.com/owner/repo/issues/234). The issue should contain clear, actionable requirements.", "type": [ "number", "string" diff --git a/.github/workflows/issue-triage-agent.lock.yml b/.github/workflows/issue-triage-agent.lock.yml index 943017f828b..e153933f05c 100644 --- a/.github/workflows/issue-triage-agent.lock.yml +++ b/.github/workflows/issue-triage-agent.lock.yml @@ -199,7 +199,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -217,7 +217,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/mergefest.lock.yml b/.github/workflows/mergefest.lock.yml index 6f917ad8a70..65005d56e86 100644 --- a/.github/workflows/mergefest.lock.yml +++ b/.github/workflows/mergefest.lock.yml @@ -247,7 +247,7 @@ jobs: "type": "string" }, "pull_request_number": { - "description": "Pull request number to push changes to. Required when the workflow target is '*' (any PR).", + "description": "Pull request number to push changes to. This is the numeric ID from the GitHub URL (e.g., 654 in github.com/owner/repo/pull/654). Required when the workflow target is '*' (any PR).", "type": [ "number", "string" diff --git a/.github/workflows/org-wide-rollout.lock.yml b/.github/workflows/org-wide-rollout.lock.yml index da9b30f2c2f..57b5d4adb10 100644 --- a/.github/workflows/org-wide-rollout.lock.yml +++ b/.github/workflows/org-wide-rollout.lock.yml @@ -277,7 +277,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -310,7 +310,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -361,7 +361,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/pdf-summary.lock.yml b/.github/workflows/pdf-summary.lock.yml index ea7f83826e6..cf5ac6b68fb 100644 --- a/.github/workflows/pdf-summary.lock.yml +++ b/.github/workflows/pdf-summary.lock.yml @@ -291,7 +291,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/plan.lock.yml b/.github/workflows/plan.lock.yml index 47ecba22d4c..8f3104077e2 100644 --- a/.github/workflows/plan.lock.yml +++ b/.github/workflows/plan.lock.yml @@ -262,7 +262,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -295,7 +295,7 @@ jobs: "type": "string" }, "discussion_number": { - "description": "Discussion number to close. If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger).", + "description": "Discussion number to close. This is the numeric ID from the GitHub URL (e.g., 678 in github.com/owner/repo/discussions/678). If omitted, closes the discussion that triggered this workflow (requires a discussion event trigger).", "type": [ "number", "string" diff --git a/.github/workflows/playground-org-project-update-issue.lock.yml b/.github/workflows/playground-org-project-update-issue.lock.yml index e85967b36ea..23c32598ddb 100644 --- a/.github/workflows/playground-org-project-update-issue.lock.yml +++ b/.github/workflows/playground-org-project-update-issue.lock.yml @@ -288,7 +288,7 @@ jobs: "type": "string" }, "content_number": { - "description": "Issue or pull request number to add to the project (e.g., 123 for issue #123). Required when content_type is 'issue' or 'pull_request'.", + "description": "Issue or pull request number to add to the project. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123 for issue #123, or 456 in github.com/owner/repo/pull/456 for PR #456). Required when content_type is 'issue' or 'pull_request'.", "type": "number" }, "content_type": { diff --git a/.github/workflows/poem-bot.lock.yml b/.github/workflows/poem-bot.lock.yml index 0f5023fec5b..1e3519632b2 100644 --- a/.github/workflows/poem-bot.lock.yml +++ b/.github/workflows/poem-bot.lock.yml @@ -280,7 +280,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -356,7 +356,7 @@ jobs: "type": "string" }, "pull_request_number": { - "description": "Pull request number to close. If omitted, closes the PR that triggered this workflow (requires a pull_request event trigger).", + "description": "Pull request number to close. This is the numeric ID from the GitHub URL (e.g., 432 in github.com/owner/repo/pull/432). If omitted, closes the PR that triggered this workflow (requires a pull_request event trigger).", "type": [ "number", "string" @@ -380,7 +380,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -476,7 +476,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { @@ -504,7 +504,7 @@ jobs: "type": "string" }, "issue_number": { - "description": "Issue number to update. Required when the workflow target is '*' (any issue).", + "description": "Issue number to update. This is the numeric ID from the GitHub URL (e.g., 789 in github.com/owner/repo/issues/789). Required when the workflow target is '*' (any issue).", "type": [ "number", "string" @@ -541,7 +541,7 @@ jobs: "type": "string" }, "pull_request_number": { - "description": "Pull request number to push changes to. Required when the workflow target is '*' (any PR).", + "description": "Pull request number to push changes to. This is the numeric ID from the GitHub URL (e.g., 654 in github.com/owner/repo/pull/654). Required when the workflow target is '*' (any PR).", "type": [ "number", "string" @@ -621,14 +621,14 @@ jobs: "additionalProperties": false, "properties": { "parent_issue_number": { - "description": "The parent issue number to link the sub-issue to.", + "description": "The parent issue number to link the sub-issue to. This is the numeric ID from the GitHub URL (e.g., 100 in github.com/owner/repo/issues/100).", "type": [ "number", "string" ] }, "sub_issue_number": { - "description": "The issue number to link as a sub-issue of the parent.", + "description": "The issue number to link as a sub-issue of the parent. This is the numeric ID from the GitHub URL (e.g., 101 in github.com/owner/repo/issues/101).", "type": [ "number", "string" diff --git a/.github/workflows/pr-nitpick-reviewer.lock.yml b/.github/workflows/pr-nitpick-reviewer.lock.yml index 0e027458553..a66ff90a469 100644 --- a/.github/workflows/pr-nitpick-reviewer.lock.yml +++ b/.github/workflows/pr-nitpick-reviewer.lock.yml @@ -310,7 +310,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/q.lock.yml b/.github/workflows/q.lock.yml index 6b27340bd41..c3e70521540 100644 --- a/.github/workflows/q.lock.yml +++ b/.github/workflows/q.lock.yml @@ -320,7 +320,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/scout.lock.yml b/.github/workflows/scout.lock.yml index 5eef9a76548..f51a358a9bd 100644 --- a/.github/workflows/scout.lock.yml +++ b/.github/workflows/scout.lock.yml @@ -318,7 +318,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/security-compliance.lock.yml b/.github/workflows/security-compliance.lock.yml index 095f0f6167c..dd08a6eda92 100644 --- a/.github/workflows/security-compliance.lock.yml +++ b/.github/workflows/security-compliance.lock.yml @@ -261,7 +261,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/semantic-function-refactor.lock.yml b/.github/workflows/semantic-function-refactor.lock.yml index 1a4e7fdb079..fcf3abc6aac 100644 --- a/.github/workflows/semantic-function-refactor.lock.yml +++ b/.github/workflows/semantic-function-refactor.lock.yml @@ -227,7 +227,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -260,7 +260,7 @@ jobs: "type": "string" }, "issue_number": { - "description": "Issue number to close. If omitted, closes the issue that triggered this workflow (requires an issue event trigger).", + "description": "Issue number to close. This is the numeric ID from the GitHub URL (e.g., 901 in github.com/owner/repo/issues/901). If omitted, closes the issue that triggered this workflow (requires an issue event trigger).", "type": [ "number", "string" diff --git a/.github/workflows/smoke-claude.lock.yml b/.github/workflows/smoke-claude.lock.yml index 8d51a7ea078..d3eabe1e998 100644 --- a/.github/workflows/smoke-claude.lock.yml +++ b/.github/workflows/smoke-claude.lock.yml @@ -277,7 +277,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -310,7 +310,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -328,7 +328,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/smoke-codex-firewall.lock.yml b/.github/workflows/smoke-codex-firewall.lock.yml index 045e7cbf62d..04c0b21369b 100644 --- a/.github/workflows/smoke-codex-firewall.lock.yml +++ b/.github/workflows/smoke-codex-firewall.lock.yml @@ -249,7 +249,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -282,7 +282,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -300,7 +300,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/smoke-codex.lock.yml b/.github/workflows/smoke-codex.lock.yml index ddc52e51098..fb7938b15c3 100644 --- a/.github/workflows/smoke-codex.lock.yml +++ b/.github/workflows/smoke-codex.lock.yml @@ -273,7 +273,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -306,7 +306,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -324,7 +324,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/smoke-copilot-no-firewall.lock.yml b/.github/workflows/smoke-copilot-no-firewall.lock.yml index b923258e4c9..7214bb67804 100644 --- a/.github/workflows/smoke-copilot-no-firewall.lock.yml +++ b/.github/workflows/smoke-copilot-no-firewall.lock.yml @@ -256,7 +256,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -274,7 +274,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/smoke-copilot-playwright.lock.yml b/.github/workflows/smoke-copilot-playwright.lock.yml index 8ce66603f95..6929df9a986 100644 --- a/.github/workflows/smoke-copilot-playwright.lock.yml +++ b/.github/workflows/smoke-copilot-playwright.lock.yml @@ -283,7 +283,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -316,7 +316,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -334,7 +334,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/smoke-copilot-safe-inputs.lock.yml b/.github/workflows/smoke-copilot-safe-inputs.lock.yml index a74f1735e89..83d8dfc0009 100644 --- a/.github/workflows/smoke-copilot-safe-inputs.lock.yml +++ b/.github/workflows/smoke-copilot-safe-inputs.lock.yml @@ -218,7 +218,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -236,7 +236,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/smoke-copilot.lock.yml b/.github/workflows/smoke-copilot.lock.yml index ee8a2b104ee..65bef79fe16 100644 --- a/.github/workflows/smoke-copilot.lock.yml +++ b/.github/workflows/smoke-copilot.lock.yml @@ -263,7 +263,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -296,7 +296,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -314,7 +314,7 @@ jobs: "additionalProperties": false, "properties": { "item_number": { - "description": "Issue or PR number to add labels to. If omitted, adds labels to the item that triggered this workflow.", + "description": "Issue or PR number to add labels to. This is the numeric ID from the GitHub URL (e.g., 456 in github.com/owner/repo/issues/456). If omitted, adds labels to the item that triggered this workflow.", "type": "number" }, "labels": { diff --git a/.github/workflows/smoke-detector.lock.yml b/.github/workflows/smoke-detector.lock.yml index b262b8c209e..547b4e1759b 100644 --- a/.github/workflows/smoke-detector.lock.yml +++ b/.github/workflows/smoke-detector.lock.yml @@ -299,7 +299,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -332,7 +332,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/speckit-dispatcher.lock.yml b/.github/workflows/speckit-dispatcher.lock.yml index 2470ce0f2f8..ddc3b765cc5 100644 --- a/.github/workflows/speckit-dispatcher.lock.yml +++ b/.github/workflows/speckit-dispatcher.lock.yml @@ -285,7 +285,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -318,7 +318,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -379,14 +379,14 @@ jobs: "additionalProperties": false, "properties": { "parent_issue_number": { - "description": "The parent issue number to link the sub-issue to.", + "description": "The parent issue number to link the sub-issue to. This is the numeric ID from the GitHub URL (e.g., 100 in github.com/owner/repo/issues/100).", "type": [ "number", "string" ] }, "sub_issue_number": { - "description": "The issue number to link as a sub-issue of the parent.", + "description": "The issue number to link as a sub-issue of the parent. This is the numeric ID from the GitHub URL (e.g., 101 in github.com/owner/repo/issues/101).", "type": [ "number", "string" diff --git a/.github/workflows/stale-repo-identifier.lock.yml b/.github/workflows/stale-repo-identifier.lock.yml index 79343bcc025..6f856fbd46e 100644 --- a/.github/workflows/stale-repo-identifier.lock.yml +++ b/.github/workflows/stale-repo-identifier.lock.yml @@ -316,7 +316,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/sub-issue-closer.lock.yml b/.github/workflows/sub-issue-closer.lock.yml index 7f5a437bf99..bfffd44b42b 100644 --- a/.github/workflows/sub-issue-closer.lock.yml +++ b/.github/workflows/sub-issue-closer.lock.yml @@ -218,7 +218,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -240,7 +240,7 @@ jobs: "type": "string" }, "issue_number": { - "description": "Issue number to update. Required when the workflow target is '*' (any issue).", + "description": "Issue number to update. This is the numeric ID from the GitHub URL (e.g., 789 in github.com/owner/repo/issues/789). Required when the workflow target is '*' (any issue).", "type": [ "number", "string" diff --git a/.github/workflows/super-linter.lock.yml b/.github/workflows/super-linter.lock.yml index 2f5f09ad22c..a98a4c90c1d 100644 --- a/.github/workflows/super-linter.lock.yml +++ b/.github/workflows/super-linter.lock.yml @@ -249,7 +249,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/technical-doc-writer.lock.yml b/.github/workflows/technical-doc-writer.lock.yml index 5dd9282852c..74b4beb52bf 100644 --- a/.github/workflows/technical-doc-writer.lock.yml +++ b/.github/workflows/technical-doc-writer.lock.yml @@ -257,7 +257,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/tidy.lock.yml b/.github/workflows/tidy.lock.yml index d16bf561c63..d57b4ec2f74 100644 --- a/.github/workflows/tidy.lock.yml +++ b/.github/workflows/tidy.lock.yml @@ -303,7 +303,7 @@ jobs: "type": "string" }, "pull_request_number": { - "description": "Pull request number to push changes to. Required when the workflow target is '*' (any PR).", + "description": "Pull request number to push changes to. This is the numeric ID from the GitHub URL (e.g., 654 in github.com/owner/repo/pull/654). Required when the workflow target is '*' (any PR).", "type": [ "number", "string" diff --git a/.github/workflows/unbloat-docs.lock.yml b/.github/workflows/unbloat-docs.lock.yml index 59f143410ad..fc24514d3ab 100644 --- a/.github/workflows/unbloat-docs.lock.yml +++ b/.github/workflows/unbloat-docs.lock.yml @@ -277,7 +277,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, diff --git a/.github/workflows/video-analyzer.lock.yml b/.github/workflows/video-analyzer.lock.yml index 5b12f97e0a0..a1fa4e17c54 100644 --- a/.github/workflows/video-analyzer.lock.yml +++ b/.github/workflows/video-analyzer.lock.yml @@ -240,7 +240,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" diff --git a/.github/workflows/workflow-generator.lock.yml b/.github/workflows/workflow-generator.lock.yml index d1e0c68fa27..ced2d1ae09b 100644 --- a/.github/workflows/workflow-generator.lock.yml +++ b/.github/workflows/workflow-generator.lock.yml @@ -232,7 +232,7 @@ jobs: "type": "string" }, "issue_number": { - "description": "Issue number to assign the Copilot agent to. The issue should contain clear, actionable requirements.", + "description": "Issue number to assign the Copilot agent to. This is the numeric ID from the GitHub URL (e.g., 234 in github.com/owner/repo/issues/234). The issue should contain clear, actionable requirements.", "type": [ "number", "string" @@ -256,7 +256,7 @@ jobs: "type": "string" }, "issue_number": { - "description": "Issue number to update. Required when the workflow target is '*' (any issue).", + "description": "Issue number to update. This is the numeric ID from the GitHub URL (e.g., 789 in github.com/owner/repo/issues/789). Required when the workflow target is '*' (any issue).", "type": [ "number", "string" diff --git a/.github/workflows/workflow-health-manager.lock.yml b/.github/workflows/workflow-health-manager.lock.yml index aa5be61f50b..81e81ca76ce 100644 --- a/.github/workflows/workflow-health-manager.lock.yml +++ b/.github/workflows/workflow-health-manager.lock.yml @@ -228,7 +228,7 @@ jobs: "type": "array" }, "parent": { - "description": "Parent issue number for creating sub-issues. Can be a real issue number (e.g., 42) or a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", + "description": "Parent issue number for creating sub-issues. This is the numeric ID from the GitHub URL (e.g., 42 in github.com/owner/repo/issues/42). Can also be a temporary_id (e.g., 'aw_abc123def456') from a previously created issue in the same workflow run.", "type": [ "number", "string" @@ -261,7 +261,7 @@ jobs: "type": "string" }, "item_number": { - "description": "The issue, pull request, or discussion number to comment on. Must be a valid existing item in the repository.", + "description": "The issue, pull request, or discussion number to comment on. This is the numeric ID from the GitHub URL (e.g., 123 in github.com/owner/repo/issues/123). Must be a valid existing item in the repository. Required.", "type": "number" } }, @@ -283,7 +283,7 @@ jobs: "type": "string" }, "issue_number": { - "description": "Issue number to update. Required when the workflow target is '*' (any issue).", + "description": "Issue number to update. This is the numeric ID from the GitHub URL (e.g., 789 in github.com/owner/repo/issues/789). Required when the workflow target is '*' (any issue).", "type": [ "number", "string"