azdo-cli 0.22.0-develop.886 → 0.22.0-develop.894

package/dist/index.js

@@ -5025,6 +5025,8 @@ async function resolvePrCommandContext(options, resolveOpts = {}) {
     pat: credential
   };
 }
+var DESCRIPTION_TRUNCATION_NOTE = '\nNote: in --json, "description" is cut at 400 characters (a limit of the Azure DevOps list endpoint).\nFor the full text run: azdo pr comments --pr-number <N> --json  (pullRequest.description).\n';
+var STATUS_DESCRIPTION_TRUNCATION_NOTE = '\nNote: when looking the PR up by branch (default or --branch), "description" in --json is cut at 400 characters\n(a limit of the Azure DevOps list endpoint); with --pr-number the full description is returned.\nFor the full text run: azdo pr comments --pr-number <N> --json  (pullRequest.description).\n';
 var STATUS_PR_NUMBER_HELP = "show only the pull request with this numeric id, instead of the current branch's pull requests; mutually exclusive with --branch";
 var STATUS_BRANCH_HELP = "show the pull requests whose source branch is this one (with or without the refs/heads/ prefix), instead of the current branch's; no checkout needed. Mutually exclusive with --pr-number";
 function parseStatusTarget(options) {
@@ -5063,7 +5065,7 @@ async function findStatusPullRequests(resolved, target) {
 }
 function createPrStatusCommand() {
   const command = new Command13("status");
-  withCommonPrOptions(configureUnwrappedHelp(command)).description("Check pull requests for the current branch, another branch, or a specific pull request").option("--pr-number <id>", STATUS_PR_NUMBER_HELP).option("--branch <name>", STATUS_BRANCH_HELP).option("--json", "output JSON").action(async (options) => {
+  withCommonPrOptions(configureUnwrappedHelp(command)).description("Check pull requests for the current branch, another branch, or a specific pull request").option("--pr-number <id>", STATUS_PR_NUMBER_HELP).option("--branch <name>", STATUS_BRANCH_HELP).option("--json", "output JSON").addHelpText("after", STATUS_DESCRIPTION_TRUNCATION_NOTE).action(async (options) => {
     validateOrgProjectPair(options);
     const target = parseStatusTarget(options);
     if (target === null) {
@@ -5393,7 +5395,10 @@ function createPrUpdateCommand() {
   withCommonPrOptions(configureUnwrappedHelp(command)).alias("edit").description("Update a pull request's title and/or description").option("--pr-number <N>", PR_NUMBER_HELP).option("--title <title>", "new pull request title").option("--title-file <path>", 'read the new title from a UTF-8 file; "-" reads standard input').option(
     "--description <description>",
     'new pull request description; REPLACES the existing description literally \u2014 no repository pull request template is looked up or prepended, unlike "azdo pr open"'
-  ).option("--description-file <path>", 'read the new description from a UTF-8 file; "-" reads standard input').option("--json", "output JSON").action(async (_options, command2) => {
+  ).option("--description-file <path>", 'read the new description from a UTF-8 file; "-" reads standard input').option("--json", "output JSON").addHelpText(
+    "after",
+    '\nNote: the description is replaced literally. To edit it, start from the full text returned by\n"azdo pr comments --pr-number <N> --json" (pullRequest.description), never from "pr list" or\n"pr status" (by branch): those cut it at 400 characters, and writing that back deletes the rest.\n'
+  ).action(async (_options, command2) => {
     await runPrUpdate(mergedPrOptions(command2));
   });
   return command;
@@ -6267,7 +6272,7 @@ async function attachWorkItemIds(context, repo, cred, pullRequests) {
 }
 function createPrListCommand() {
   const command = new Command13("list");
-  withCommonPrOptions(configureUnwrappedHelp(command)).description("List pull requests in the repository, optionally filtered by source branch").option("--branch <name>", "only pull requests whose source branch is this one (with or without the refs/heads/ prefix)").option("--status <status>", `pull request status filter (${LIST_STATUS_VALUES.join(" | ")})`, "active").option("--top <N>", `maximum number of pull requests to return (default ${DEFAULT_LIST_TOP})`).option("--work-items", "also return the ids of each pull request's linked work items (one extra API call per pull request)").option("--json", "output JSON").action(async (options) => {
+  withCommonPrOptions(configureUnwrappedHelp(command)).description("List pull requests in the repository, optionally filtered by source branch").option("--branch <name>", "only pull requests whose source branch is this one (with or without the refs/heads/ prefix)").option("--status <status>", `pull request status filter (${LIST_STATUS_VALUES.join(" | ")})`, "active").option("--top <N>", `maximum number of pull requests to return (default ${DEFAULT_LIST_TOP})`).option("--work-items", "also return the ids of each pull request's linked work items (one extra API call per pull request)").option("--json", "output JSON").addHelpText("after", DESCRIPTION_TRUNCATION_NOTE).action(async (options) => {
     validateOrgProjectPair(options);
     const parsed = parseListOptions(options);
     if (parsed === null) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.22.0-develop.886",
+  "version": "0.22.0-develop.894",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {