postman-cli-completion 1.62.0 → 1.63.0

package/completions/bash/postman.bash

@@ -1,4 +1,4 @@
-# Bash completion for Postman CLI (postman v1.62.0)
+# Bash completion for Postman CLI (postman v1.63.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -179,7 +179,7 @@ _postman_collection() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "new migrate lint ai-readiness get request list run" -- "$cur") )
+      COMPREPLY=( $(compgen -W "new migrate lint ai-readiness get request folder list run" -- "$cur") )
     fi
     return 0
   fi
@@ -190,6 +190,7 @@ _postman_collection() {
     ai-readiness) _postman_collection_ai_readiness ;;
     get) _postman_collection_get ;;
     request) _postman_collection_request ;;
+    folder) _postman_collection_folder ;;
     list) _postman_collection_list ;;
     run) _postman_collection_run ;;
   esac
@@ -298,6 +299,49 @@ _postman_collection_request_rm() {
   esac
 }
 
+_postman_collection_folder() {
+  if [[ -z "$subcmd" ]]; then
+    if [[ "$cur" == -* ]]; then
+      COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
+    else
+      COMPREPLY=( $(compgen -W "add update rm remove" -- "$cur") )
+    fi
+    return 0
+  fi
+  case "$subcmd" in
+    add) _postman_collection_folder_add ;;
+    update) _postman_collection_folder_update ;;
+    rm|remove) _postman_collection_folder_rm ;;
+  esac
+}
+
+_postman_collection_folder_add() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--collection --folder -w --workspace --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
+_postman_collection_folder_update() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--collection --folder --name --description --auth --scripts -w --workspace --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
+_postman_collection_folder_rm() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--collection --folder -y --yes -w --workspace --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
 _postman_collection_list() {
   if [[ "$cur" == -* ]]; then
     COMPREPLY=( $(compgen -W "-w --workspace -f --filter --verbose --debug --json -h --help" -- "$cur") )

package/completions/fish/postman.fish

@@ -1,4 +1,4 @@
-# Fish completion for Postman CLI (postman v1.62.0)
+# Fish completion for Postman CLI (postman v1.63.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -76,7 +76,7 @@ complete -c postman -n '__fish_seen_subcommand_from init' -l json -d 'Emit machi
 complete -c postman -n '__fish_seen_subcommand_from init' -l dry-run -d 'Report what would happen without writing anything'
 complete -c postman -n '__fish_seen_subcommand_from init' -l no-fetch -d 'Use the skills bundled with this CLI instead of fetching the latest'
 complete -c postman -n '__fish_seen_subcommand_from init' -l spec -d 'Which spec is authoritative, when more than one could be' -r
-complete -c postman -n '__fish_seen_subcommand_from init' -l visibility -d 'Create and bind a workspace non-interactively (personal or team)' -x
+complete -c postman -n '__fish_seen_subcommand_from init' -l visibility -d 'Create and bind a workspace non-interactively (personal, team)' -x
 complete -c postman -n '__fish_seen_subcommand_from init' -l no-cloud -d 'Skip the workspace step entirely'
 complete -c postman -n '__fish_seen_subcommand_from init' -l report-events -d 'Send init analytics to Postman (requires login)'
 complete -c postman -n '__fish_seen_subcommand_from init' -s h -l help -d 'display help for command'
@@ -113,14 +113,15 @@ 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 new migrate lint ai-readiness get request 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 request 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 request 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 request 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 request 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 request list run' -a request -d 'Add, update, or remove requests in a local v3 collection.'
-complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get request 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 request list 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 request folder 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 request folder 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 request folder 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 request folder 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 request folder 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 request folder list run' -a request -d 'Add, update, or remove requests in a local v3 collection.'
+complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get request folder list run' -a folder -d 'Add, update, or remove folders in a local v3 collection.'
+complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get request folder 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 request folder 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
@@ -183,6 +184,35 @@ 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 request; and __fish_seen_subcommand_from rm' -l type -d 'Request type for cloud mode: http, graphql, grpc, websocket, socketio. (default: "http")' -x
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from rm' -l json -d 'JSON output.'
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from rm' -s h -l help -d 'display help for command'
+# ---------- collection folder ----------
+complete -c postman -n '__postman_using_subcommand folder add update rm remove' -a add -d 'Add an empty folder to a local v3 collection (set its details later with `update`).'
+complete -c postman -n '__postman_using_subcommand folder add update rm remove' -a update -d 'Update a folder in a v3 collection (only the fields you pass).'
+complete -c postman -n '__postman_using_subcommand folder add update rm remove' -a rm -d 'Remove a folder from a v3 collection (recursive: removes everything inside it).'
+complete -c postman -n '__postman_using_subcommand folder add update rm remove' -a remove -d 'Alias for rm'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder' -s h -l help -d 'display help for command'
+# ---------- collection folder add ----------
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from add' -l collection -d 'Target collection: name, directory, id, cloud id, or path. Required.' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from add' -l folder -d 'Parent folder within the collection, e.g. "Users/Admin". Defaults to the root.' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from add' -s w -l workspace -d 'Target a Postman cloud workspace by id (cloud mode).' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from add' -l json -d 'JSON output.'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from add' -s h -l help -d 'display help for command'
+# ---------- collection folder update ----------
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from update' -l collection -d 'Target collection: name, directory, id, cloud id, or path (cloud: id only). Required.' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from update' -l folder -d 'Parent folder to scope the selector, e.g. "Users" (local: name/path; cloud: id).' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from update' -l name -d 'Rename the folder (moves its directory).' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from update' -l description -d 'Folder description.' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from update' -l auth -d 'Folder auth: none, inherit, bearer:TOKEN, basic:USER:PASS, apikey:KEY:VALUE[:header|query], oauth2:TOKEN.' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from update' -l scripts -d 'Replace folder scripts. event is prerequest or test; script is @file, - for stdin, or inline. Repeatable. (default: [])' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from update' -s w -l workspace -d 'Target a Postman cloud workspace by id (cloud mode).' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from update' -l json -d 'JSON output.'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from update' -s h -l help -d 'display help for command'
+# ---------- collection folder rm ----------
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from rm' -l collection -d 'Target collection: name, directory, id, cloud id, or path (cloud: id only). Required.' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from rm' -l folder -d 'Parent folder to scope the selector, e.g. "Users" (local: name/path; cloud: id).' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from rm' -s y -l yes -d 'Skip the confirmation prompt (required when stdout is not a TTY).'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from rm' -s w -l workspace -d 'Target a Postman cloud workspace by id (cloud mode).' -x
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from rm' -l json -d 'JSON output.'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from folder; and __fish_seen_subcommand_from rm' -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
@@ -903,7 +933,7 @@ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcom
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -s x -l suppress-exit-code -d 'Always exit with code 0, even on failure'
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -s h -l help -d 'display help for command'
 # ---------- mock run ----------
-complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s e -l environment -d 'Path to a file of environment variables for the mock. Relative or absolute, e.g. ./postman/environments/dev.json' -r
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s e -l environment -d 'Path to a file of environment variables for the mock. Relative or absolute, e.g. ./postman/environments/dev.environment.yaml' -r
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s g -l globals -d 'Path to a file of global variables for the mock. Relative or absolute, e.g. ./globals.json' -r
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s p -l port -d 'Port to run on (e.g. 4010), or "auto" for a free one. Defaults to the mock\'s configured port.' -x
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -l api-key -d 'Postman API key, used with a Postman cloud id (defaults to your `postman login` session)' -r

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.62.0)
+# Zsh completion for Postman CLI (postman v1.63.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -123,7 +123,7 @@ _postman_init() {
     '--dry-run[Report what would happen without writing anything]' \
     '--no-fetch[Use the skills bundled with this CLI instead of fetching the latest]' \
     '--spec[Which spec is authoritative, when more than one could be]:path:_files -g "*.(yaml|yml|json)"' \
-    '--visibility[Create and bind a workspace non-interactively (personal or team)]:status' \
+    '--visibility[Create and bind a workspace non-interactively (personal, team)]:status' \
     '--no-cloud[Skip the workspace step entirely]' \
     '--report-events[Send init analytics to Postman (requires login)]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
@@ -210,6 +210,7 @@ _postman_collection() {
         ai-readiness) _postman_collection_ai_readiness ;;
         get) _postman_collection_get ;;
         request) _postman_collection_request ;;
+        folder) _postman_collection_folder ;;
         list) _postman_collection_list ;;
         run) _postman_collection_run ;;
       esac
@@ -226,6 +227,7 @@ _postman_collection_commands() {
     '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.'
     'request:Add, update, or remove requests in a local v3 collection.'
+    'folder:Add, update, or remove folders in a local v3 collection.'
     '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.'
   )
@@ -345,6 +347,70 @@ _postman_collection_request_rm() {
     '*:request:'
 }
 
+_postman_collection_folder() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_collection_folder_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        add) _postman_collection_folder_add ;;
+        update) _postman_collection_folder_update ;;
+        rm|remove) _postman_collection_folder_rm ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_collection_folder_commands() {
+  local -a sub
+  sub=(
+    'add:Add an empty folder to a local v3 collection (set its details later with `update`).'
+    'update:Update a folder in a v3 collection (only the fields you pass).'
+    'rm:Remove a folder from a v3 collection (recursive\: removes everything inside it).'
+    'remove:Alias for rm'
+  )
+  _describe -t commands 'folder command' sub
+}
+
+_postman_collection_folder_add() {
+  _arguments \
+    '--collection[Target collection\: name, directory, id, cloud id, or path. Required.]:id|name' \
+    '--folder[Parent folder within the collection, e.g. "Users/Admin". Defaults to the root.]:id|name|path' \
+    '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:folder-name:'
+}
+
+_postman_collection_folder_update() {
+  _arguments \
+    '--collection[Target collection\: name, directory, id, cloud id, or path (cloud\: id only). Required.]:id|name' \
+    '--folder[Parent folder to scope the selector, e.g. "Users" (local\: name/path; cloud\: id).]:id|name|path' \
+    '--name[Rename the folder (moves its directory).]:name' \
+    '--description[Folder description.]:text' \
+    '--auth[Folder auth\: none, inherit, bearer\:TOKEN, basic\:USER\:PASS, apikey\:KEY\:VALUE\[\:header|query\], oauth2\:TOKEN.]:spec' \
+    '--scripts[Replace folder scripts. event is prerequest or test; script is @file, - for stdin, or inline. Repeatable. (default\: \[\])]:event\:script' \
+    '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:folder:'
+}
+
+_postman_collection_folder_rm() {
+  _arguments \
+    '--collection[Target collection\: name, directory, id, cloud id, or path (cloud\: id only). Required.]:id|name' \
+    '--folder[Parent folder to scope the selector, e.g. "Users" (local\: name/path; cloud\: id).]:id|name|path' \
+    '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt (required when stdout is not a TTY).]' \
+    '(-w --workspace)'{-w,--workspace}'[Target a Postman cloud workspace by id (cloud mode).]:id' \
+    '--json[JSON output.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:folder:'
+}
+
 _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' \
@@ -1717,7 +1783,7 @@ _postman_mock_generate() {
 
 _postman_mock_run() {
   _arguments \
-    '(-e --environment)'{-e,--environment}'[Path to a file of environment variables for the mock. Relative or absolute, e.g. ./postman/environments/dev.json]:path:_files -g "*.json"' \
+    '(-e --environment)'{-e,--environment}'[Path to a file of environment variables for the mock. Relative or absolute, e.g. ./postman/environments/dev.environment.yaml]:path:_files -g "*.json"' \
     '(-g --globals)'{-g,--globals}'[Path to a file of global variables for the mock. Relative or absolute, e.g. ./globals.json]:path:_files -g "*.json"' \
     '(-p --port)'{-p,--port}'[Port to run on (e.g. 4010), or "auto" for a free one. Defaults to the mock'\''s configured port.]:port' \
     '--api-key[Postman API key, used with a Postman cloud id (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \

package/package.json

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