postman-cli-completion 1.58.0 → 1.59.0

package/completions/bash/postman.bash

@@ -1,4 +1,4 @@
-# Bash completion for Postman CLI (postman v1.58.0)
+# Bash completion for Postman CLI (postman v1.59.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -22,7 +22,7 @@ _postman() {
   cur="${COMP_WORDS[COMP_CWORD]}"
   prev="${COMP_WORDS[COMP_CWORD-1]}"
 
-  local top_commands="login signup logout init whoami skills collection environment globals api runner spec monitor workspace ws performance flows fl request sdk mock application app simulate context context-graph search webhook dataset dependency"
+  local top_commands="login signup logout init whoami update skills collection environment globals api runner spec monitor workspace ws performance flows fl request sdk mock application app simulate context context-graph search webhook dataset dependency"
   local global_flags="-v --version --silent --color -h --help -h --help"
 
   local i cmd="" subcmd=""
@@ -51,6 +51,7 @@ _postman() {
     logout) _postman_logout ;;
     init) _postman_init ;;
     whoami) _postman_whoami ;;
+    update) _postman_update ;;
     skills) _postman_skills ;;
     collection) _postman_collection ;;
     environment) _postman_environment ;;
@@ -90,7 +91,7 @@ _postman_login() {
 
 _postman_signup() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--browser --json -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "--browser --wait --no-wait --json -h --help" -- "$cur") )
     return 0
   fi
 }
@@ -124,6 +125,13 @@ _postman_whoami() {
   fi
 }
 
+_postman_update() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
+    return 0
+  fi
+}
+
 _postman_skills() {
   if [[ -z "$subcmd" ]]; then
     if [[ "$cur" == -* ]]; then
@@ -160,18 +168,30 @@ _postman_collection() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "migrate lint ai-readiness run" -- "$cur") )
+      COMPREPLY=( $(compgen -W "new migrate lint ai-readiness get list run" -- "$cur") )
     fi
     return 0
   fi
   case "$subcmd" in
+    new) _postman_collection_new ;;
     migrate) _postman_collection_migrate ;;
     lint) _postman_collection_lint ;;
     ai-readiness) _postman_collection_ai_readiness ;;
+    get) _postman_collection_get ;;
+    list) _postman_collection_list ;;
     run) _postman_collection_run ;;
   esac
 }
 
+_postman_collection_new() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-w --workspace --force --verbose --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
 _postman_collection_migrate() {
   if [[ "$cur" == -* ]]; then
     COMPREPLY=( $(compgen -W "-o --output -h --help" -- "$cur") )
@@ -205,6 +225,27 @@ _postman_collection_ai_readiness() {
   _postman_filematch '!*.@(json)' "$cur"
 }
 
+_postman_collection_get() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--api-key --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
+}
+
+_postman_collection_list() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-w --workspace -f --filter --verbose --debug --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
 _postman_collection_run() {
   if [[ "$cur" == -* ]]; then
     COMPREPLY=( $(compgen -W "-e --environment -g --globals -r --reporters --output --reporter-json-structure -n --iteration-count -d --iteration-data --iteration-data-dataset --iteration-data-view --dataset -i --global-var --env-var --integration-id --postman-api-key --alias --bail --ignore-redirects -x --suppress-exit-code --silent --disable-unicode --delay-request --timeout --timeout-request --timeout-script --working-dir --no-insecure-file-read -k --insecure --ssl-client-cert-list --ssl-client-cert --ssl-client-key --ssl-client-passphrase --ssl-extra-ca-certs --cookie-jar --export-cookie-jar --verbose --mock --port --use-mock --simulate --report-events --no-report-events -h --help --reporter-json-export --reporter-junit-export --reporter-html-export --reporter-json-omitRequestBodies --reporter-html-omitRequestBodies --reporter-json-omitResponseBodies --reporter-html-omitResponseBodies --reporter-json-omitHeaders --reporter-html-omitHeaders --reporter-json-omitAllHeadersAndBody --reporter-html-omitAllHeadersAndBody" -- "$cur") )
@@ -277,11 +318,12 @@ _postman_environment() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "list get var lint" -- "$cur") )
+      COMPREPLY=( $(compgen -W "new list get var lint" -- "$cur") )
     fi
     return 0
   fi
   case "$subcmd" in
+    new) _postman_environment_new ;;
     list) _postman_environment_list ;;
     get) _postman_environment_get ;;
     var) _postman_environment_var ;;
@@ -289,6 +331,15 @@ _postman_environment() {
   esac
 }
 
+_postman_environment_new() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-w --workspace --force --verbose --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
 _postman_environment_list() {
   if [[ "$cur" == -* ]]; then
     COMPREPLY=( $(compgen -W "-w --workspace -f --filter --verbose --json -h --help" -- "$cur") )
@@ -463,7 +514,7 @@ _postman_runner_start() {
 
 _postman_runner_list() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--api-key --json -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "--api-key -w --workspace --json -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
@@ -490,7 +541,7 @@ _postman_spec() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "lint ai-readiness list get file create" -- "$cur") )
+      COMPREPLY=( $(compgen -W "lint ai-readiness list get file create generate" -- "$cur") )
     fi
     return 0
   fi
@@ -501,6 +552,7 @@ _postman_spec() {
     get) _postman_spec_get ;;
     file) _postman_spec_file ;;
     create) _postman_spec_create ;;
+    generate) _postman_spec_generate ;;
   esac
 }
 
@@ -615,12 +667,38 @@ _postman_spec_create() {
   _postman_filematch '!*.@(json)' "$cur"
 }
 
+_postman_spec_generate() {
+  if [[ -z "$subcmd" ]]; then
+    if [[ "$cur" == -* ]]; then
+      COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
+    else
+      COMPREPLY=( $(compgen -W "collection" -- "$cur") )
+    fi
+    return 0
+  fi
+  case "$subcmd" in
+    collection) _postman_spec_generate_collection ;;
+  esac
+}
+
+_postman_spec_generate_collection() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-n --name --folder-strategy -w --workspace --api-key -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
+}
+
 _postman_monitor() {
   if [[ -z "$subcmd" ]]; then
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "run create update delete jobs runs list get pause resume" -- "$cur") )
+      COMPREPLY=( $(compgen -W "run create update delete jobs runs list get metrics pause resume" -- "$cur") )
     fi
     return 0
   fi
@@ -633,6 +711,7 @@ _postman_monitor() {
     runs) _postman_monitor_runs ;;
     list) _postman_monitor_list ;;
     get) _postman_monitor_get ;;
+    metrics) _postman_monitor_metrics ;;
     pause) _postman_monitor_pause ;;
     resume) _postman_monitor_resume ;;
   esac
@@ -775,6 +854,18 @@ _postman_monitor_get() {
   esac
 }
 
+_postman_monitor_metrics() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--api-key --since --until -f --filter --limit --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
+}
+
 _postman_monitor_pause() {
   if [[ "$cur" == -* ]]; then
     COMPREPLY=( $(compgen -W "--api-key --json -h --help" -- "$cur") )
@@ -804,7 +895,7 @@ _postman_workspace() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "list prepare push lint create pull connect-git" -- "$cur") )
+      COMPREPLY=( $(compgen -W "list prepare push lint create pull connect-git diff" -- "$cur") )
     fi
     return 0
   fi
@@ -816,6 +907,7 @@ _postman_workspace() {
     create) _postman_workspace_create ;;
     pull) _postman_workspace_pull ;;
     connect-git) _postman_workspace_connect_git ;;
+    diff) _postman_workspace_diff ;;
   esac
 }
 
@@ -882,17 +974,27 @@ _postman_workspace_connect_git() {
   _postman_filematch '!*.@(json)' "$cur"
 }
 
+_postman_workspace_diff() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--push-strategy --summary --json --exit-code --verbose --timeout -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
 _postman_performance() {
   if [[ -z "$subcmd" ]]; then
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "run" -- "$cur") )
+      COMPREPLY=( $(compgen -W "run runs" -- "$cur") )
     fi
     return 0
   fi
   case "$subcmd" in
     run) _postman_performance_run ;;
+    runs) _postman_performance_runs ;;
   esac
 }
 
@@ -909,6 +1011,15 @@ _postman_performance_run() {
   _postman_filematch '!*.@(json)' "$cur"
 }
 
+_postman_performance_runs() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-c --collection-id --cursor --json --timeout -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
 _postman_flows() {
   if [[ -z "$subcmd" ]]; then
     if [[ "$cur" == -* ]]; then

package/completions/fish/postman.fish

@@ -1,10 +1,10 @@
-# Fish completion for Postman CLI (postman v1.58.0)
+# Fish completion for Postman CLI (postman v1.59.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
 
 function __postman_no_subcommand
-    not __fish_seen_subcommand_from login signup logout init whoami skills collection environment globals api runner spec monitor workspace ws performance flows fl request sdk mock application app simulate context context-graph search webhook dataset dependency
+    not __fish_seen_subcommand_from login signup logout init whoami update skills collection environment globals api runner spec monitor workspace ws performance flows fl request sdk mock application app simulate context context-graph search webhook dataset dependency
 end
 
 function __postman_using_subcommand
@@ -22,10 +22,11 @@ complete -c postman -n __postman_no_subcommand -s h -l help -d 'display help for
 
 # ---------- Top-level commands ----------
 complete -c postman -n __postman_no_subcommand -a login -d 'Authenticate with Postman to access your resources.'
-complete -c postman -n __postman_no_subcommand -a signup -d 'Sign up to keep the work you created as a guest (claims your guest workspace). By default prints a single-use sign-up URL to open in a browser; --browser signs up in a browser and signs this CLI in.'
+complete -c postman -n __postman_no_subcommand -a signup -d 'Sign up to keep the work you created as a guest (claims your guest workspace). Waits and signs this CLI in once the sign-up is completed in a browser — opening that browser here on a terminal, or printing the URL to hand over when output is piped.'
 complete -c postman -n __postman_no_subcommand -a logout -d 'Delete the stored Postman API key.'
 complete -c postman -n __postman_no_subcommand -a init -d 'Set up Postman artifacts and agent instructions in a repository.'
 complete -c postman -n __postman_no_subcommand -a whoami -d 'Show the Postman account or guest session this CLI session is using.'
+complete -c postman -n __postman_no_subcommand -a update -d 'Update Postman CLI using the original installation method.'
 complete -c postman -n __postman_no_subcommand -a skills -d 'Check and update the agent skills in this repository.'
 complete -c postman -n __postman_no_subcommand -a collection -d 'Run and test your Postman collections directly from the command line.'
 complete -c postman -n __postman_no_subcommand -a environment -d 'Work with local Postman environments from the command line. Also read cloud environments by ID.'
@@ -60,7 +61,9 @@ complete -c postman -n '__fish_seen_subcommand_from login' -l verbose -d 'Show d
 complete -c postman -n '__fish_seen_subcommand_from login' -s h -l help -d 'display help for command'
 
 # ---------- signup ----------
-complete -c postman -n '__fish_seen_subcommand_from signup' -l browser -d 'Open a browser to sign up and sign this CLI in, instead of printing a URL.'
+complete -c postman -n '__fish_seen_subcommand_from signup' -l browser -d 'Always open the sign-up URL in a browser here, rather than printing it.'
+complete -c postman -n '__fish_seen_subcommand_from signup' -l wait -d 'Wait for the sign-up to complete even if no local browser is detected.'
+complete -c postman -n '__fish_seen_subcommand_from signup' -l no-wait -d 'Print the sign-up URL and exit without waiting. Leaves this CLI a guest.'
 complete -c postman -n '__fish_seen_subcommand_from signup' -l json -d 'Print the sign-up details as machine-readable JSON.'
 complete -c postman -n '__fish_seen_subcommand_from signup' -s h -l help -d 'display help for command'
 
@@ -83,6 +86,9 @@ complete -c postman -n '__fish_seen_subcommand_from init' -r -k -a '(__fish_comp
 complete -c postman -n '__fish_seen_subcommand_from whoami' -l json -d 'Print current identity as machine-readable JSON.'
 complete -c postman -n '__fish_seen_subcommand_from whoami' -s h -l help -d 'display help for command'
 
+# ---------- update ----------
+complete -c postman -n '__fish_seen_subcommand_from update' -s h -l help -d 'display help for command'
+
 # ---------- skills ----------
 complete -c postman -n '__postman_using_subcommand skills status update' -a status -d 'Report whether this repository\'s skills are up to date.'
 complete -c postman -n '__postman_using_subcommand skills status update' -a update -d 'Fetch the latest skills into this repository.'
@@ -100,11 +106,20 @@ complete -c postman -n '__fish_seen_subcommand_from skills; and __fish_seen_subc
 complete -c postman -n '__fish_seen_subcommand_from skills; and __fish_seen_subcommand_from update' -r -k -a '(__fish_complete_suffix .json)'
 
 # ---------- collection ----------
-complete -c postman -n '__postman_using_subcommand collection migrate lint ai-readiness run' -a migrate -d 'Migrate a v2.1 collection to the v3 format'
-complete -c postman -n '__postman_using_subcommand collection migrate lint ai-readiness run' -a lint -d 'Run linting on a local v3 collection at the given file or directory path.'
-complete -c postman -n '__postman_using_subcommand collection migrate lint ai-readiness run' -a ai-readiness -d 'Score a Postman collection for AI readiness by ID, local file path, or local-mode directory.'
-complete -c postman -n '__postman_using_subcommand collection migrate lint ai-readiness run' -a run -d 'Initiate a Postman collection run from a given ID or path.'
+complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get list run' -a new -d 'Scaffold a v3 collection on disk, or create one in a cloud Postman workspace with --workspace.'
+complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get list run' -a migrate -d 'Migrate a v2.1 collection to the v3 format'
+complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get list run' -a lint -d 'Run linting on a local v3 collection at the given file or directory path.'
+complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get list run' -a ai-readiness -d 'Score a Postman collection for AI readiness by ID, local file path, or local-mode directory.'
+complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get list run' -a get -d 'Fetch a Postman collection in the V3 format and print it.'
+complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get list run' -a list -d 'List collections: your local project\'s collections by default, or a Postman cloud workspace\'s collections with --workspace.'
+complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get list run' -a run -d 'Initiate a Postman collection run from a given ID or path.'
 complete -c postman -n '__fish_seen_subcommand_from collection' -s h -l help -d 'display help for command'
+# ---------- collection new ----------
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from new' -s w -l workspace -d 'Create the collection in a cloud Postman workspace instead of scaffolding it locally. Required when the current directory is not a local Postman workspace.' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from new' -l force -d 'Rewrite the definition of an existing local collection. Existing request files are left alone.'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from new' -l verbose -d 'Verbose output'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from new' -l json -d 'JSON output'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from new' -s h -l help -d 'display help for command'
 # ---------- collection migrate ----------
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from migrate' -s o -l output -d 'Output directory (default: ./<collection-name>)' -r
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from migrate' -s h -l help -d 'display help for command'
@@ -119,6 +134,17 @@ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from ai-readiness' -l min-score -d 'Exit with a non-zero code if the overall score is below this threshold (0-100).' -x
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from ai-readiness' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from ai-readiness' -r -k -a '(__fish_complete_suffix .json)'
+# ---------- collection get ----------
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from get' -l api-key -d 'Postman API key (defaults to your `postman login` session)' -r
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from get' -l json -d 'Print the collection as machine-readable V3 JSON instead of a table'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
+# ---------- collection list ----------
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from list' -s w -l workspace -d 'List a Postman cloud workspace\'s collections by id. Omit to list the local project\'s collections.' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from list' -s f -l filter -d 'Filter collections by name.' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from list' -l verbose -d 'Verbose output'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from list' -l debug -d 'Debug output'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from list' -l json -d 'JSON output'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
 # ---------- collection run ----------
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -s e -l environment -d 'Specify an Id or path to a Postman Environment' -r
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -s g -l globals -d 'Specify an Id or path to a file containing Postman Globals' -r
@@ -177,11 +203,18 @@ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
 
 # ---------- environment ----------
-complete -c postman -n '__postman_using_subcommand environment list get var lint' -a list -d 'List environments in a Postman workspace.'
-complete -c postman -n '__postman_using_subcommand environment list get var lint' -a get -d 'Read an environment by ID or local environment file path.'
-complete -c postman -n '__postman_using_subcommand environment list get var lint' -a var -d 'Read and update environment variables.'
-complete -c postman -n '__postman_using_subcommand environment list get var lint' -a lint -d 'Run linting on a local Postman environment at the given file or directory path.'
+complete -c postman -n '__postman_using_subcommand environment new list get var lint' -a new -d 'Scaffold a local environment file, or create one in a Postman workspace with --workspace.'
+complete -c postman -n '__postman_using_subcommand environment new list get var lint' -a list -d 'List environments in a Postman workspace.'
+complete -c postman -n '__postman_using_subcommand environment new list get var lint' -a get -d 'Read an environment by ID or local environment file path.'
+complete -c postman -n '__postman_using_subcommand environment new list get var lint' -a var -d 'Read and update environment variables.'
+complete -c postman -n '__postman_using_subcommand environment new list get var lint' -a lint -d 'Run linting on a local Postman environment at the given file or directory path.'
 complete -c postman -n '__fish_seen_subcommand_from environment' -s h -l help -d 'display help for command'
+# ---------- environment new ----------
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from new' -s w -l workspace -d 'Create the environment in a cloud Postman workspace instead of scaffolding it locally. Required when the current directory is not a local Postman workspace.' -x
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from new' -l force -d 'Overwrite an existing local environment file.'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from new' -l verbose -d 'Verbose output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from new' -l json -d 'JSON output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from new' -s h -l help -d 'display help for command'
 # ---------- environment list ----------
 complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from list' -s w -l workspace -d 'Workspace ID to list environments from.' -x
 complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from list' -s f -l filter -d 'Filter environments by name.' -x
@@ -270,6 +303,7 @@ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subc
 complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from start' -s h -l help -d 'display help for command'
 # ---------- runner list ----------
 complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
+complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from list' -s w -l workspace -d 'Filter to runners in this workspace' -x
 complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from list' -l json -d 'Output the runner list as JSON instead of a table'
 complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
 # ---------- runner regions ----------
@@ -278,12 +312,13 @@ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subc
 complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from regions' -s h -l help -d 'display help for command'
 
 # ---------- spec ----------
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create' -a lint -d 'Run linting on the given specification by ID or local file path.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create' -a ai-readiness -d 'Score an OpenAPI specification for AI readiness by ID or local file path.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create' -a list -d 'List local spec files under a path, or (no path) a workspace\'s cloud specs.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create' -a get -d 'Read a spec definition, including every file of a multi-file spec.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create' -a file -d 'Add, update, or remove files in a spec (cloud ID or local directory).'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create' -a create -d 'Create a new spec in a workspace, or (with path) scaffold a local spec file.'
+complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate' -a lint -d 'Run linting on the given specification by ID or local file path.'
+complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate' -a ai-readiness -d 'Score an OpenAPI specification for AI readiness by ID or local file path.'
+complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate' -a list -d 'List local spec files under a path, or (no path) a workspace\'s cloud specs.'
+complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate' -a get -d 'Read a spec definition, including every file of a multi-file spec.'
+complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate' -a file -d 'Add, update, or remove files in a spec (cloud ID or local directory).'
+complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate' -a create -d 'Create a new spec in a workspace, or (with path) scaffold a local spec file.'
+complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate' -a generate -d 'Generate artifacts from a specification.'
 complete -c postman -n '__fish_seen_subcommand_from spec' -s h -l help -d 'display help for command'
 # ---------- spec lint ----------
 complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -s f -l fail-severity -d 'Results of this level or above will trigger a failure exit code. [choices: "error", "warning", "info", "hint"] (default: "ERROR")' -x
@@ -336,18 +371,28 @@ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcom
 complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from create' -l api-key -d 'Postman API key' -r
 complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from create' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from create' -r -k -a '(__fish_complete_suffix .json)'
+# ---------- spec generate ----------
+complete -c postman -n '__postman_using_subcommand generate collection' -a collection -d 'Generate a Postman collection from a specification.'
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate' -s h -l help -d 'display help for command'
+# ---------- spec generate collection ----------
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate; and __fish_seen_subcommand_from collection' -s n -l name -d 'Collection name' -x
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate; and __fish_seen_subcommand_from collection' -l folder-strategy -d 'Folder strategy: Paths or Tags (default: Paths) (default: "Paths")' -x
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate; and __fish_seen_subcommand_from collection' -s w -l workspace -d 'Workspace ID (cloud mode)' -x
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate; and __fish_seen_subcommand_from collection' -l api-key -d 'Postman API key' -r
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate; and __fish_seen_subcommand_from collection' -s h -l help -d 'display help for command'
 
 # ---------- monitor ----------
-complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get pause resume' -a run -d 'Invoke a monitor run and display results.'
-complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get pause resume' -a create -d 'Create a collection-based monitor.'
-complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get pause resume' -a update -d 'Update a monitor\'s schedule, runner, notifications or run options.'
-complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get pause resume' -a delete -d 'Permanently delete a monitor. Prompts for confirmation unless --yes is passed.'
-complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get pause resume' -a jobs -d 'Inspect a monitor\'s jobs and their per-region runs.'
-complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get pause resume' -a runs -d 'Inspect a monitor run\'s attempts.'
-complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get pause resume' -a list -d 'List the monitors visible to you.'
-complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get pause resume' -a get -d 'Show a monitor\'s configuration.'
-complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get pause resume' -a pause -d 'Pause a monitor, so it stops firing on schedule.'
-complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get pause resume' -a resume -d 'Resume a paused monitor, so it fires on schedule again.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a run -d 'Invoke a monitor run and display results.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a create -d 'Create a collection-based monitor.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a update -d 'Update a monitor\'s schedule, runner, notifications or run options.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a delete -d 'Permanently delete a monitor. Prompts for confirmation unless --yes is passed.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a jobs -d 'Inspect a monitor\'s jobs and their per-region runs.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a runs -d 'Inspect a monitor run\'s attempts.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a list -d 'List the monitors visible to you.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a get -d 'Show a monitor\'s configuration.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a metrics -d 'Show per-request latency and outcome history for a monitor.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a pause -d 'Pause a monitor, so it stops firing on schedule.'
+complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a resume -d 'Resume a paused monitor, so it fires on schedule again.'
 complete -c postman -n '__fish_seen_subcommand_from monitor' -s h -l help -d 'display help for command'
 # ---------- monitor run ----------
 complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from run' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
@@ -456,6 +501,14 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
 complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from get' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from get' -l json -d 'Output as JSON instead of a table'
 complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
+# ---------- monitor metrics ----------
+complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
+complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l since -d 'Only executions at or after this ISO 8601 date-time. Defaults to 7 days ago.' -x
+complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l until -d 'Only executions at or before this ISO 8601 date-time. Defaults to now.' -x
+complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -s f -l filter -d 'Show only requests whose name contains this text (case-insensitive)' -x
+complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l limit -d 'Cap the number of rows shown: executions (newest first) under --json, or table rows (worst-behaving request first) otherwise. Not honoured by the service -- there is no server-side pagination on this route.' -x
+complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -l json -d 'Output as JSON instead of a table'
+complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from metrics' -s h -l help -d 'display help for command'
 # ---------- monitor pause ----------
 complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from pause' -l api-key -d 'Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from pause' -l json -d 'Output as JSON instead of a table'
@@ -466,13 +519,14 @@ complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_sub
 complete -c postman -n '__fish_seen_subcommand_from monitor; and __fish_seen_subcommand_from resume' -s h -l help -d 'display help for command'
 
 # ---------- workspace ----------
-complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git' -a list -d 'List all available Postman Workspaces'
-complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git' -a prepare -d 'Prepare local collections and environments for push by validating and regenerating IDs if needed.'
-complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git' -a push -d 'Push local workspace entities (collections, environments, specifications, mocks and more) to Postman workspace.'
-complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git' -a lint -d 'Lint the current local Postman workspace: its configuration (.postman/resources.yaml) plus every discovered entity. Use --meta to lint only the configuration.'
-complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git' -a create -d 'Create a Postman workspace and bind it to this git repository.'
-complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git' -a pull -d 'Pull workspace entities from a Postman workspace into the local git-native folder.'
-complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git' -a connect-git -d 'Connect a Postman workspace to a local git repository.'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a list -d 'List all available Postman Workspaces'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a prepare -d 'Prepare local collections and environments for push by validating and regenerating IDs if needed.'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a push -d 'Push local workspace entities (collections, environments, specifications, mocks and more) to Postman workspace.'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a lint -d 'Lint the current local Postman workspace: its configuration (.postman/resources.yaml) plus every discovered entity. Use --meta to lint only the configuration.'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a create -d 'Create a Postman workspace and bind it to this git repository.'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a pull -d 'Pull workspace entities from a Postman workspace into the local git-native folder.'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a connect-git -d 'Connect a Postman workspace to a local git repository.'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push lint create pull connect-git diff' -a diff -d 'Preview local-vs-cloud drift before pushing. Read-only: nothing is created, updated or deleted.'
 complete -c postman -n '__fish_seen_subcommand_from workspace' -s h -l help -d 'display help for command'
 # ---------- workspace list ----------
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from list' -s f -l filter -d 'Filter workspaces by name.' -x
@@ -516,9 +570,18 @@ complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_s
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from connect-git' -l verbose -d 'Show detailed logging'
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from connect-git' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from connect-git' -r -k -a '(__fish_complete_suffix .json)'
+# ---------- workspace diff ----------
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from diff' -l push-strategy -d 'Strategy to preview. "force-sync" also shows cloud entities that would be DELETED. Defaults to "force-sync".' -x
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from diff' -l summary -d 'Skip content comparison. Faster, but updates are listed without checking whether they changed.'
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from diff' -l json -d 'Print the diff as machine-readable JSON.'
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from diff' -l exit-code -d 'Exit with code 1 when drift is found (for CI gates).'
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from diff' -l verbose -d 'Show detailed logging'
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from diff' -l timeout -d 'Abort the run after this many milliseconds. Defaults to 120000.' -x
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from diff' -s h -l help -d 'display help for command'
 
 # ---------- performance ----------
-complete -c postman -n '__postman_using_subcommand performance run' -a run -d 'Run a performance test on a collection'
+complete -c postman -n '__postman_using_subcommand performance run runs' -a run -d 'Run a performance test on a collection'
+complete -c postman -n '__postman_using_subcommand performance run runs' -a runs -d 'List past performance runs for a collection, newest first.'
 complete -c postman -n '__fish_seen_subcommand_from performance' -s h -l help -d 'display help for command'
 # ---------- performance run ----------
 complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s e -l environment -d 'Specify an Id to a Postman Environment' -x
@@ -538,6 +601,12 @@ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen
 complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l use-mock -d 'Redirect a variable/host to a local code mock or cloud Mock Server (repeatable). Format: "<{{var}}|host> mock|mock-server:<path|id> [scenario]" (default: [])' -x
 complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
+# ---------- performance runs ----------
+complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from runs' -s c -l collection-id -d 'Collection ID whose performance runs to list' -x
+complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from runs' -l cursor -d 'Pagination cursor from a previous page\'s response' -x
+complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from runs' -l json -d 'Output as JSON instead of a table'
+complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from runs' -l timeout -d 'Milliseconds to wait for the service before failing (default: "30000")' -x
+complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from runs' -s h -l help -d 'display help for command'
 
 # ---------- flows ----------
 complete -c postman -n '__postman_using_subcommand flows list trigger deploy run update list-runs get-run' -a list -d 'List all flows'
@@ -754,7 +823,7 @@ complete -c postman -n '__postman_using_subcommand mock generate run push deploy
 complete -c postman -n '__postman_using_subcommand mock generate run push deploy get list log delete' -a push -d 'Upload a mock from your repository to Postman cloud (creates it the first time, updates it after).'
 complete -c postman -n '__postman_using_subcommand mock generate run push deploy get list log delete' -a deploy -d 'Turn a mock in Postman cloud into a live mock server others can call over the internet.'
 complete -c postman -n '__postman_using_subcommand mock generate run push deploy get list log delete' -a get -d 'Show a mock\'s details using its path if it lives in your repository, or its id if it lives in Postman cloud.'
-complete -c postman -n '__postman_using_subcommand mock generate run push deploy get list log delete' -a list -d 'List the mocks in your Postman cloud workspace, or — with a folder path — the mocks in that folder in your repository.'
+complete -c postman -n '__postman_using_subcommand mock generate run push deploy get list log delete' -a list -d 'List the mocks in your repository or Postman cloud workspace'
 complete -c postman -n '__postman_using_subcommand mock generate run push deploy get list log delete' -a log -d 'Show the requests a live mock server has received and the responses it sent, using its id.'
 complete -c postman -n '__postman_using_subcommand mock generate run push deploy get list log delete' -a delete -d 'Delete a mock using its path if it lives in your repository, or its id if it lives in Postman cloud. Cannot be undone.'
 complete -c postman -n '__fish_seen_subcommand_from mock' -s h -l help -d 'display help for command'

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.58.0)
+# Zsh completion for Postman CLI (postman v1.59.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -25,6 +25,7 @@ _postman() {
         logout) _postman_logout ;;
         init) _postman_init ;;
         whoami) _postman_whoami ;;
+        update) _postman_update ;;
         skills) _postman_skills ;;
         collection) _postman_collection ;;
         environment) _postman_environment ;;
@@ -56,10 +57,11 @@ _postman_commands() {
   local -a commands
   commands=(
     'login:Authenticate with Postman to access your resources.'
-    'signup:Sign up to keep the work you created as a guest (claims your guest workspace). By default prints a single-use sign-up URL to open in a browser; --browser signs up in a browser and signs this CLI in.'
+    'signup:Sign up to keep the work you created as a guest (claims your guest workspace). Waits and signs this CLI in once the sign-up is completed in a browser — opening that browser here on a terminal, or printing the URL to hand over when output is piped.'
     'logout:Delete the stored Postman API key.'
     'init:Set up Postman artifacts and agent instructions in a repository.'
     'whoami:Show the Postman account or guest session this CLI session is using.'
+    'update:Update Postman CLI using the original installation method.'
     'skills:Check and update the agent skills in this repository.'
     'collection:Run and test your Postman collections directly from the command line.'
     'environment:Work with local Postman environments from the command line. Also read cloud environments by ID.'
@@ -100,7 +102,9 @@ _postman_login() {
 
 _postman_signup() {
   _arguments \
-    '--browser[Open a browser to sign up and sign this CLI in, instead of printing a URL.]' \
+    '--browser[Always open the sign-up URL in a browser here, rather than printing it.]' \
+    '--wait[Wait for the sign-up to complete even if no local browser is detected.]' \
+    '--no-wait[Print the sign-up URL and exit without waiting. Leaves this CLI a guest.]' \
     '--json[Print the sign-up details as machine-readable JSON.]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
@@ -130,6 +134,11 @@ _postman_whoami() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
+_postman_update() {
+  _arguments \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 _postman_skills() {
   local context state state_descr line
   typeset -A opt_args
@@ -183,9 +192,12 @@ _postman_collection() {
   case $state in
     args)
       case $words[1] in
+        new) _postman_collection_new ;;
         migrate) _postman_collection_migrate ;;
         lint) _postman_collection_lint ;;
         ai-readiness) _postman_collection_ai_readiness ;;
+        get) _postman_collection_get ;;
+        list) _postman_collection_list ;;
         run) _postman_collection_run ;;
       esac
       ;;
@@ -195,14 +207,27 @@ _postman_collection() {
 _postman_collection_commands() {
   local -a sub
   sub=(
+    'new:Scaffold a v3 collection on disk, or create one in a cloud Postman workspace with --workspace.'
     'migrate:Migrate a v2.1 collection to the v3 format'
     'lint:Run linting on a local v3 collection at the given file or directory path.'
     'ai-readiness:Score a Postman collection for AI readiness by ID, local file path, or local-mode directory.'
+    'get:Fetch a Postman collection in the V3 format and print it.'
+    'list:List collections\: your local project'\''s collections by default, or a Postman cloud workspace'\''s collections with --workspace.'
     'run:Initiate a Postman collection run from a given ID or path.'
   )
   _describe -t commands 'collection command' sub
 }
 
+_postman_collection_new() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Create the collection in a cloud Postman workspace instead of scaffolding it locally. Required when the current directory is not a local Postman workspace.]:workspaceId' \
+    '--force[Rewrite the definition of an existing local collection. Existing request files are left alone.]' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:name:'
+}
+
 _postman_collection_migrate() {
   _arguments \
     '(-o --output)'{-o,--output}'[Output directory (default\: ./<collection-name>)]:dir:_files -g "*.json"' \
@@ -226,6 +251,24 @@ _postman_collection_ai_readiness() {
     '*:collectionId/Path:_files -g "*.json"'
 }
 
+_postman_collection_get() {
+  _arguments \
+    '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Print the collection as machine-readable V3 JSON instead of a table]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:id:'
+}
+
+_postman_collection_list() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[List a Postman cloud workspace'\''s collections by id. Omit to list the local project'\''s collections.]:workspaceId' \
+    '(-f --filter)'{-f,--filter}'[Filter collections by name.]:name' \
+    '--verbose[Verbose output]' \
+    '--debug[Debug output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 _postman_collection_run() {
   _arguments \
     '(-e --environment)'{-e,--environment}'[Specify an Id or path to a Postman Environment]:path:_files -g "*.json"' \
@@ -295,6 +338,7 @@ _postman_environment() {
   case $state in
     args)
       case $words[1] in
+        new) _postman_environment_new ;;
         list) _postman_environment_list ;;
         get) _postman_environment_get ;;
         var) _postman_environment_var ;;
@@ -307,6 +351,7 @@ _postman_environment() {
 _postman_environment_commands() {
   local -a sub
   sub=(
+    'new:Scaffold a local environment file, or create one in a Postman workspace with --workspace.'
     'list:List environments in a Postman workspace.'
     'get:Read an environment by ID or local environment file path.'
     'var:Read and update environment variables.'
@@ -315,6 +360,16 @@ _postman_environment_commands() {
   _describe -t commands 'environment command' sub
 }
 
+_postman_environment_new() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Create the environment in a cloud Postman workspace instead of scaffolding it locally. Required when the current directory is not a local Postman workspace.]:workspaceId' \
+    '--force[Overwrite an existing local environment file.]' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:name:'
+}
+
 _postman_environment_list() {
   _arguments \
     '(-w --workspace)'{-w,--workspace}'[Workspace ID to list environments from.]:workspaceId' \
@@ -524,6 +579,7 @@ _postman_runner_start() {
 _postman_runner_list() {
   _arguments \
     '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-w --workspace)'{-w,--workspace}'[Filter to runners in this workspace]:id' \
     '--json[Output the runner list as JSON instead of a table]' \
     '(-h --help)'{-h,--help}'[display help for command]'
 }
@@ -551,6 +607,7 @@ _postman_spec() {
         get) _postman_spec_get ;;
         file) _postman_spec_file ;;
         create) _postman_spec_create ;;
+        generate) _postman_spec_generate ;;
       esac
       ;;
   esac
@@ -565,6 +622,7 @@ _postman_spec_commands() {
     'get:Read a spec definition, including every file of a multi-file spec.'
     'file:Add, update, or remove files in a spec (cloud ID or local directory).'
     'create:Create a new spec in a workspace, or (with path) scaffold a local spec file.'
+    'generate:Generate artifacts from a specification.'
   )
   _describe -t commands 'spec command' sub
 }
@@ -670,6 +728,40 @@ _postman_spec_create() {
     '*:path:_files -g "*.json"'
 }
 
+_postman_spec_generate() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_spec_generate_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        collection) _postman_spec_generate_collection ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_spec_generate_commands() {
+  local -a sub
+  sub=(
+    'collection:Generate a Postman collection from a specification.'
+  )
+  _describe -t commands 'generate command' sub
+}
+
+_postman_spec_generate_collection() {
+  _arguments \
+    '(-n --name)'{-n,--name}'[Collection name]:name' \
+    '--folder-strategy[Folder strategy\: Paths or Tags (default\: Paths) (default\: "Paths")]:strategy' \
+    '(-w --workspace)'{-w,--workspace}'[Workspace ID (cloud mode)]:id' \
+    '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:spec:'
+}
+
 _postman_monitor() {
   local context state state_descr line
   typeset -A opt_args
@@ -688,6 +780,7 @@ _postman_monitor() {
         runs) _postman_monitor_runs ;;
         list) _postman_monitor_list ;;
         get) _postman_monitor_get ;;
+        metrics) _postman_monitor_metrics ;;
         pause) _postman_monitor_pause ;;
         resume) _postman_monitor_resume ;;
       esac
@@ -706,6 +799,7 @@ _postman_monitor_commands() {
     'runs:Inspect a monitor run'\''s attempts.'
     'list:List the monitors visible to you.'
     'get:Show a monitor'\''s configuration.'
+    'metrics:Show per-request latency and outcome history for a monitor.'
     'pause:Pause a monitor, so it stops firing on schedule.'
     'resume:Resume a paused monitor, so it fires on schedule again.'
   )
@@ -896,6 +990,18 @@ _postman_monitor_get() {
     '*:monitorId:'
 }
 
+_postman_monitor_metrics() {
+  _arguments \
+    '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--since[Only executions at or after this ISO 8601 date-time. Defaults to 7 days ago.]:dateTime' \
+    '--until[Only executions at or before this ISO 8601 date-time. Defaults to now.]:dateTime' \
+    '(-f --filter)'{-f,--filter}'[Show only requests whose name contains this text (case-insensitive)]:text' \
+    '--limit[Cap the number of rows shown\: executions (newest first) under --json, or table rows (worst-behaving request first) otherwise. Not honoured by the service -- there is no server-side pagination on this route.]:n' \
+    '--json[Output as JSON instead of a table]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:monitorId:'
+}
+
 _postman_monitor_pause() {
   _arguments \
     '--api-key[Postman API key (defaults to POSTMAN_API_KEY, then the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
@@ -929,6 +1035,7 @@ _postman_workspace() {
         create) _postman_workspace_create ;;
         pull) _postman_workspace_pull ;;
         connect-git) _postman_workspace_connect_git ;;
+        diff) _postman_workspace_diff ;;
       esac
       ;;
   esac
@@ -944,6 +1051,7 @@ _postman_workspace_commands() {
     'create:Create a Postman workspace and bind it to this git repository.'
     'pull:Pull workspace entities from a Postman workspace into the local git-native folder.'
     'connect-git:Connect a Postman workspace to a local git repository.'
+    'diff:Preview local-vs-cloud drift before pushing. Read-only\: nothing is created, updated or deleted.'
   )
   _describe -t commands 'workspace command' sub
 }
@@ -1012,6 +1120,18 @@ _postman_workspace_connect_git() {
     '*:path:_files -g "*.json"'
 }
 
+_postman_workspace_diff() {
+  _arguments \
+    '--push-strategy[Strategy to preview. "force-sync" also shows cloud entities that would be DELETED. Defaults to "force-sync".]:strategy' \
+    '--summary[Skip content comparison. Faster, but updates are listed without checking whether they changed.]' \
+    '--json[Print the diff as machine-readable JSON.]' \
+    '--exit-code[Exit with code 1 when drift is found (for CI gates).]' \
+    '--verbose[Show detailed logging]' \
+    '--timeout[Abort the run after this many milliseconds. Defaults to 120000.]:ms' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:workspaceId:'
+}
+
 _postman_performance() {
   local context state state_descr line
   typeset -A opt_args
@@ -1023,6 +1143,7 @@ _postman_performance() {
     args)
       case $words[1] in
         run) _postman_performance_run ;;
+        runs) _postman_performance_runs ;;
       esac
       ;;
   esac
@@ -1032,6 +1153,7 @@ _postman_performance_commands() {
   local -a sub
   sub=(
     'run:Run a performance test on a collection'
+    'runs:List past performance runs for a collection, newest first.'
   )
   _describe -t commands 'performance command' sub
 }
@@ -1057,6 +1179,16 @@ _postman_performance_run() {
     '*:collectionId:_files -g "*.json"'
 }
 
+_postman_performance_runs() {
+  _arguments \
+    '(-c --collection-id)'{-c,--collection-id}'[Collection ID whose performance runs to list]:id' \
+    '--cursor[Pagination cursor from a previous page'\''s response]:token' \
+    '--json[Output as JSON instead of a table]' \
+    '--timeout[Milliseconds to wait for the service before failing (default\: "30000")]:ms' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:id:'
+}
+
 _postman_flows() {
   local context state state_descr line
   typeset -A opt_args
@@ -1428,7 +1560,7 @@ _postman_mock_commands() {
     'push:Upload a mock from your repository to Postman cloud (creates it the first time, updates it after).'
     'deploy:Turn a mock in Postman cloud into a live mock server others can call over the internet.'
     'get:Show a mock'\''s details using its path if it lives in your repository, or its id if it lives in Postman cloud.'
-    'list:List the mocks in your Postman cloud workspace, or — with a folder path — the mocks in that folder in your repository.'
+    'list:List the mocks in your repository or Postman cloud workspace'
     'log:Show the requests a live mock server has received and the responses it sent, using its id.'
     'delete:Delete a mock using its path if it lives in your repository, or its id if it lives in Postman cloud. Cannot be undone.'
   )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postman-cli-completion",
-  "version": "1.58.0",
+  "version": "1.59.0",
   "description": "Shell completions for the Postman CLI (zsh, bash, fish)",
   "type": "module",
   "bin": {