postman-cli-completion 1.56.3 → 1.57.0

package/completions/bash/postman.bash

@@ -1,4 +1,4 @@
-# Bash completion for Postman CLI (postman v1.56.3)
+# Bash completion for Postman CLI (postman v1.57.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 logout init skills collection environment globals api runner spec monitor workspace ws performance flows fl request sdk mock application app simulate context search webhook dataset"
+  local top_commands="login signup logout init 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=""
@@ -47,6 +47,7 @@ _postman() {
 
   case "$cmd" in
     login) _postman_login ;;
+    signup) _postman_signup ;;
     logout) _postman_logout ;;
     init) _postman_init ;;
     skills) _postman_skills ;;
@@ -66,9 +67,11 @@ _postman() {
     application|app) _postman_application ;;
     simulate) _postman_simulate ;;
     context) _postman_context ;;
+    context-graph) _postman_context_graph ;;
     search) _postman_search ;;
     webhook) _postman_webhook ;;
     dataset) _postman_dataset ;;
+    dependency) _postman_dependency ;;
   esac
 }
 
@@ -84,6 +87,13 @@ _postman_login() {
   esac
 }
 
+_postman_signup() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--browser --json -h --help" -- "$cur") )
+    return 0
+  fi
+}
+
 _postman_logout() {
   if [[ "$cur" == -* ]]; then
     COMPREPLY=( $(compgen -W "--alias -h --help" -- "$cur") )
@@ -259,15 +269,89 @@ _postman_environment() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "lint" -- "$cur") )
+      COMPREPLY=( $(compgen -W "list get var lint" -- "$cur") )
     fi
     return 0
   fi
   case "$subcmd" in
+    list) _postman_environment_list ;;
+    get) _postman_environment_get ;;
+    var) _postman_environment_var ;;
     lint) _postman_environment_lint ;;
   esac
 }
 
+_postman_environment_list() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-w --workspace -f --filter --verbose --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
+_postman_environment_get() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--verbose --json --show-secrets -h --help" -- "$cur") )
+    return 0
+  fi
+  _postman_filematch '!*.@(json)' "$cur"
+}
+
+_postman_environment_var() {
+  if [[ -z "$subcmd" ]]; then
+    if [[ "$cur" == -* ]]; then
+      COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
+    else
+      COMPREPLY=( $(compgen -W "set get unset" -- "$cur") )
+    fi
+    return 0
+  fi
+  case "$subcmd" in
+    set) _postman_environment_var_set ;;
+    get) _postman_environment_var_get ;;
+    unset) _postman_environment_var_unset ;;
+  esac
+}
+
+_postman_environment_var_set() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-e --environment --verbose --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    -e|--environment)
+      _postman_filematch '!*.@(json)' "$cur"
+      return 0 ;;
+  esac
+}
+
+_postman_environment_var_get() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-e --environment --verbose --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    -e|--environment)
+      _postman_filematch '!*.@(json)' "$cur"
+      return 0 ;;
+  esac
+  _postman_filematch '!*.@(json)' "$cur"
+}
+
+_postman_environment_var_unset() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-e --environment --verbose --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    -e|--environment)
+      _postman_filematch '!*.@(json)' "$cur"
+      return 0 ;;
+  esac
+  _postman_filematch '!*.@(json)' "$cur"
+}
+
 _postman_environment_lint() {
   if [[ "$cur" == -* ]]; then
     COMPREPLY=( $(compgen -W "-f --fail-severity -o --output -h --help" -- "$cur") )
@@ -372,13 +456,15 @@ _postman_spec() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "lint ai-readiness" -- "$cur") )
+      COMPREPLY=( $(compgen -W "lint ai-readiness list get" -- "$cur") )
     fi
     return 0
   fi
   case "$subcmd" in
     lint) _postman_spec_lint ;;
     ai-readiness) _postman_spec_ai_readiness ;;
+    list) _postman_spec_list ;;
+    get) _postman_spec_get ;;
   esac
 }
 
@@ -400,6 +486,31 @@ _postman_spec_ai_readiness() {
   esac
 }
 
+_postman_spec_list() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-w --workspace --api-key --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
+  _postman_filematch '!*.@(json)' "$cur"
+}
+
+_postman_spec_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_monitor() {
   if [[ -z "$subcmd" ]]; then
     if [[ "$cur" == -* ]]; then
@@ -1155,6 +1266,45 @@ _postman_context_environment_get() {
   esac
 }
 
+_postman_context_graph() {
+  if [[ -z "$subcmd" ]]; then
+    if [[ "$cur" == -* ]]; then
+      COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
+    else
+      COMPREPLY=( $(compgen -W "ask status" -- "$cur") )
+    fi
+    return 0
+  fi
+  case "$subcmd" in
+    ask) _postman_context_graph_ask ;;
+    status) _postman_context_graph_status ;;
+  esac
+}
+
+_postman_context_graph_ask() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--wait --api-key --json --no-include-answer --max-steps --interval --timeout -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
+}
+
+_postman_context_graph_status() {
+  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_search() {
   if [[ -z "$subcmd" ]]; then
     if [[ "$cur" == -* ]]; then
@@ -1659,4 +1809,27 @@ _postman_dataset_view_update() {
   esac
 }
 
+_postman_dependency() {
+  if [[ -z "$subcmd" ]]; then
+    if [[ "$cur" == -* ]]; then
+      COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
+    else
+      COMPREPLY=( $(compgen -W "add" -- "$cur") )
+    fi
+    return 0
+  fi
+  case "$subcmd" in
+    add) _postman_dependency_add ;;
+  esac
+}
+
+_postman_dependency_add() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-w --workspace -y --yes --json -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
 complete -F _postman postman

package/completions/fish/postman.fish

@@ -1,10 +1,10 @@
-# Fish completion for Postman CLI (postman v1.56.3)
+# Fish completion for Postman CLI (postman v1.57.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 logout init skills collection environment globals api runner spec monitor workspace ws performance flows fl request sdk mock application app simulate context search webhook dataset
+    not __fish_seen_subcommand_from login signup logout init 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,11 +22,12 @@ 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 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 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.'
+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.'
 complete -c postman -n __postman_no_subcommand -a globals -d 'Work with local Postman globals from the command line.'
 complete -c postman -n __postman_no_subcommand -a api -d 'Publish and test your APIs directly from the command line'
 complete -c postman -n __postman_no_subcommand -a runner -d 'Run runners on your own environments for monitoring your APIs'
@@ -44,9 +45,11 @@ complete -c postman -n __postman_no_subcommand -a application -d 'Application-le
 complete -c postman -n __postman_no_subcommand -a app -d 'Alias for application'
 complete -c postman -n __postman_no_subcommand -a simulate -d 'Start mock servers with simulated failure scenarios.'
 complete -c postman -n __postman_no_subcommand -a context -d '[Beta] Get API context for AI coding agents directly from the command line.'
+complete -c postman -n __postman_no_subcommand -a context-graph -d 'Ask natural-language questions about your team\'s Context Graph.'
 complete -c postman -n __postman_no_subcommand -a search -d 'Search for Postman element types (requests, collections, workspaces, and more).'
 complete -c postman -n __postman_no_subcommand -a webhook -d 'Create and manage Postman webhooks.'
 complete -c postman -n __postman_no_subcommand -a dataset -d 'Work with Postman datasets in local YAML files or the cloud.'
+complete -c postman -n __postman_no_subcommand -a dependency -d 'Manage workspace dependencies (Postman entities reused from other workspaces).'
 
 # ---------- login ----------
 complete -c postman -n '__fish_seen_subcommand_from login' -l alias -d 'Specify the alias of the API key to fetch your resources using it. (This option is discontinued and will be removed in a future release.)' -x
@@ -55,6 +58,11 @@ complete -c postman -n '__fish_seen_subcommand_from login' -l region -d 'Specify
 complete -c postman -n '__fish_seen_subcommand_from login' -l verbose -d 'Show detailed error information'
 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 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'
+
 # ---------- logout ----------
 complete -c postman -n '__fish_seen_subcommand_from logout' -l alias -d 'Specify the alias of the API key to fetch your resources using it. (This option is discontinued and will be removed in a future release.)' -x
 complete -c postman -n '__fish_seen_subcommand_from logout' -s h -l help -d 'display help for command'
@@ -164,8 +172,45 @@ 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 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 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 '__fish_seen_subcommand_from environment' -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
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from list' -l verbose -d 'Verbose output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from list' -l json -d 'JSON output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
+# ---------- environment get ----------
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from get' -l verbose -d 'Verbose output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from get' -l json -d 'JSON output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from get' -l show-secrets -d 'Show secret variable values in output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from get' -r -k -a '(__fish_complete_suffix .json)'
+# ---------- environment var ----------
+complete -c postman -n '__postman_using_subcommand var set get unset' -a set -d 'Set one variable in an environment.'
+complete -c postman -n '__postman_using_subcommand var set get unset' -a get -d 'Read one variable value from an environment.'
+complete -c postman -n '__postman_using_subcommand var set get unset' -a unset -d 'Remove one variable from an environment.'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var' -s h -l help -d 'display help for command'
+# ---------- environment var set ----------
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from set' -s e -l environment -d 'Cloud Environment ID or local environment file path.' -r
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from set' -l verbose -d 'Verbose output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from set' -l json -d 'JSON output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from set' -s h -l help -d 'display help for command'
+# ---------- environment var get ----------
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from get' -s e -l environment -d 'Cloud Environment ID or local environment file path.' -r
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from get' -l verbose -d 'Verbose output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from get' -l json -d 'JSON output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from get' -r -k -a '(__fish_complete_suffix .json)'
+# ---------- environment var unset ----------
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from unset' -s e -l environment -d 'Cloud Environment ID or local environment file path.' -r
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from unset' -l verbose -d 'Verbose output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from unset' -l json -d 'JSON output'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from unset' -s h -l help -d 'display help for command'
+complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from var; and __fish_seen_subcommand_from unset' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- environment lint ----------
 complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from lint' -s f -l fail-severity -d 'Exit with failure if diagnostics at this level or above are present. [choices: "error", "warning"] (default: "error")' -x
 complete -c postman -n '__fish_seen_subcommand_from environment; and __fish_seen_subcommand_from lint' -s o -l output -d 'Output format: cli (human-readable), table, json, or csv. (default: "cli")' -x
@@ -217,8 +262,10 @@ 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'
 
 # ---------- spec ----------
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness' -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' -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' -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' -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' -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' -a get -d 'Read a spec definition, including every file of a multi-file spec.'
 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
@@ -231,6 +278,16 @@ 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 ai-readiness' -s o -l output -d 'Output format for the results. [choices: "cli", "json", "html"]' -x
 complete -c postman -n '__fish_seen_subcommand_from spec; 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 spec; and __fish_seen_subcommand_from ai-readiness' -s h -l help -d 'display help for command'
+# ---------- spec list ----------
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from list' -s w -l workspace -d 'Workspace ID (defaults to .postman/resources.yaml binding)' -x
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key' -r
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from list' -l json -d 'Output as JSON'
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from list' -r -k -a '(__fish_complete_suffix .json)'
+# ---------- spec get ----------
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from get' -l api-key -d 'Postman API key' -r
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from get' -l json -d 'Output as JSON (full spec definition)'
+complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
 
 # ---------- monitor ----------
 complete -c postman -n '__postman_using_subcommand monitor run' -a run -d 'Invoke a monitor run and display results.'
@@ -524,7 +581,7 @@ complete -c postman -n '__fish_seen_subcommand_from sdk; and __fish_seen_subcomm
 complete -c postman -n '__fish_seen_subcommand_from sdk; and __fish_seen_subcommand_from connections; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
 
 # ---------- mock ----------
-complete -c postman -n '__postman_using_subcommand mock generate run deploy get list log delete' -a generate -d 'Generate a runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto-detected. Omit the source to scaffold a sample mock with a GET /health endpoint. Writes a local mock by default, or a cloud mock with --workspace.'
+complete -c postman -n '__postman_using_subcommand mock generate run deploy get list log delete' -a generate -d 'Generate a runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto-detected. Omit the source to scaffold a sample shopping-cart mock (POST /cart/items, GET /cart, POST /checkout). Writes a local mock by default, or a cloud mock with --workspace.'
 complete -c postman -n '__postman_using_subcommand mock generate run deploy get list log delete' -a run -d 'Start a local mock server from a cloud mock id (fetched and run locally), a manifest file (JSON or YAML), a mock directory (postman/mocks/<slug>), or a .js handler.'
 complete -c postman -n '__postman_using_subcommand mock generate run deploy get list log delete' -a deploy -d 'Deploy a cloud mock into a mock server.'
 complete -c postman -n '__postman_using_subcommand mock generate run deploy get list log delete' -a get -d 'Show a mock\'s details: a cloud mock by id, or a local mock by path.'
@@ -682,6 +739,24 @@ complete -c postman -n '__fish_seen_subcommand_from context; and __fish_seen_sub
 complete -c postman -n '__fish_seen_subcommand_from context; and __fish_seen_subcommand_from environment; and __fish_seen_subcommand_from get' -s e -l environment-id -d 'Environment ID' -x
 complete -c postman -n '__fish_seen_subcommand_from context; and __fish_seen_subcommand_from environment; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
 
+# ---------- context-graph ----------
+complete -c postman -n '__postman_using_subcommand context-graph ask status' -a ask -d 'Ask a natural-language question about your team\'s Context Graph.'
+complete -c postman -n '__postman_using_subcommand context-graph ask status' -a status -d 'Check an ask submitted by `ask`, without blocking. Prints the answer when ready.'
+complete -c postman -n '__fish_seen_subcommand_from context-graph' -s h -l help -d 'display help for command'
+# ---------- context-graph ask ----------
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from ask' -l wait -d 'Block until the answer arrives, then print it'
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from ask' -l api-key -d 'Postman API key (falls back to POSTMAN_API_KEY, then a `postman login` session)' -r
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from ask' -l json -d 'Output the ask record as JSON'
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from ask' -l no-include-answer -d 'Do not ask the service to include the answer inline'
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from ask' -l max-steps -d 'Cap the reasoning steps the service may take (its default applies when omitted)' -x
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from ask' -l interval -d 'With --wait, seconds between polls (default: 2)' -x
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from ask' -l timeout -d 'With --wait, seconds to wait before giving up (default: 300)' -x
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from ask' -s h -l help -d 'display help for command'
+# ---------- context-graph status ----------
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from status' -l api-key -d 'Postman API key (falls back to POSTMAN_API_KEY, then a `postman login` session)' -r
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from status' -l json -d 'Output the ask record as JSON'
+complete -c postman -n '__fish_seen_subcommand_from context-graph; and __fish_seen_subcommand_from status' -s h -l help -d 'display help for command'
+
 # ---------- search ----------
 complete -c postman -n '__postman_using_subcommand search requests collections workspaces flows specs mocks environments documents' -a requests -d 'Search for requests by name or keyword.'
 complete -c postman -n '__postman_using_subcommand search requests collections workspaces flows specs mocks environments documents' -a collections -d 'Search for collections by name or keyword.'
@@ -937,3 +1012,12 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from update' -s q -l query -d 'New SQL query' -x
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from update' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from view; and __fish_seen_subcommand_from update' -s h -l help -d 'display help for command'
+
+# ---------- dependency ----------
+complete -c postman -n '__postman_using_subcommand dependency add' -a add -d 'Add a Postman collection, environment, or mock as a workspace dependency.'
+complete -c postman -n '__fish_seen_subcommand_from dependency' -s h -l help -d 'display help for command'
+# ---------- dependency add ----------
+complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from add' -s w -l workspace -d 'Workspace id to resolve a name in (defaults to the current workspace).' -x
+complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from add' -s y -l yes -d 'Skip all confirmation prompts.'
+complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from add' -l json -d 'Output the result as JSON.'
+complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from add' -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.56.3)
+# Zsh completion for Postman CLI (postman v1.57.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -21,6 +21,7 @@ _postman() {
     args)
       case $words[1] in
         login) _postman_login ;;
+        signup) _postman_signup ;;
         logout) _postman_logout ;;
         init) _postman_init ;;
         skills) _postman_skills ;;
@@ -40,9 +41,11 @@ _postman() {
         application|app) _postman_application ;;
         simulate) _postman_simulate ;;
         context) _postman_context ;;
+        context-graph) _postman_context_graph ;;
         search) _postman_search ;;
         webhook) _postman_webhook ;;
         dataset) _postman_dataset ;;
+        dependency) _postman_dependency ;;
       esac
       ;;
   esac
@@ -52,11 +55,12 @@ _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.'
     'logout:Delete the stored Postman API key.'
     'init:Set up Postman artifacts and agent instructions in a repository.'
     '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.'
+    'environment:Work with local Postman environments from the command line. Also read cloud environments by ID.'
     'globals:Work with local Postman globals from the command line.'
     'api:Publish and test your APIs directly from the command line'
     'runner:Run runners on your own environments for monitoring your APIs'
@@ -74,9 +78,11 @@ _postman_commands() {
     'app:Alias for application'
     'simulate:Start mock servers with simulated failure scenarios.'
     'context:\[Beta\] Get API context for AI coding agents directly from the command line.'
+    'context-graph:Ask natural-language questions about your team'\''s Context Graph.'
     'search:Search for Postman element types (requests, collections, workspaces, and more).'
     'webhook:Create and manage Postman webhooks.'
     'dataset:Work with Postman datasets in local YAML files or the cloud.'
+    'dependency:Manage workspace dependencies (Postman entities reused from other workspaces).'
   )
   _describe -t commands 'postman command' commands
 }
@@ -90,6 +96,13 @@ _postman_login() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
+_postman_signup() {
+  _arguments \
+    '--browser[Open a browser to sign up and sign this CLI in, instead of printing a URL.]' \
+    '--json[Print the sign-up details as machine-readable JSON.]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 _postman_logout() {
   _arguments \
     '--alias[Specify the alias of the API key to fetch your resources using it. (This option is discontinued and will be removed in a future release.)]:alias' \
@@ -274,6 +287,9 @@ _postman_environment() {
   case $state in
     args)
       case $words[1] in
+        list) _postman_environment_list ;;
+        get) _postman_environment_get ;;
+        var) _postman_environment_var ;;
         lint) _postman_environment_lint ;;
       esac
       ;;
@@ -283,11 +299,88 @@ _postman_environment() {
 _postman_environment_commands() {
   local -a sub
   sub=(
+    'list:List environments in a Postman workspace.'
+    'get:Read an environment by ID or local environment file path.'
+    'var:Read and update environment variables.'
     'lint:Run linting on a local Postman environment at the given file or directory path.'
   )
   _describe -t commands 'environment command' sub
 }
 
+_postman_environment_list() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Workspace ID to list environments from.]:workspaceId' \
+    '(-f --filter)'{-f,--filter}'[Filter environments by name.]:name' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:workspacePath:'
+}
+
+_postman_environment_get() {
+  _arguments \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '--show-secrets[Show secret variable values in output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:environment:_files -g "*.json"'
+}
+
+_postman_environment_var() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_environment_var_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        set) _postman_environment_var_set ;;
+        get) _postman_environment_var_get ;;
+        unset) _postman_environment_var_unset ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_environment_var_commands() {
+  local -a sub
+  sub=(
+    'set:Set one variable in an environment.'
+    'get:Read one variable value from an environment.'
+    'unset:Remove one variable from an environment.'
+  )
+  _describe -t commands 'var command' sub
+}
+
+_postman_environment_var_set() {
+  _arguments \
+    '(-e --environment)'{-e,--environment}'[Cloud Environment ID or local environment file path.]:environment:_files -g "*.json"' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:value:'
+}
+
+_postman_environment_var_get() {
+  _arguments \
+    '(-e --environment)'{-e,--environment}'[Cloud Environment ID or local environment file path.]:environment:_files -g "*.json"' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:key:_files -g "*.json"'
+}
+
+_postman_environment_var_unset() {
+  _arguments \
+    '(-e --environment)'{-e,--environment}'[Cloud Environment ID or local environment file path.]:environment:_files -g "*.json"' \
+    '--verbose[Verbose output]' \
+    '--json[JSON output]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:key:_files -g "*.json"'
+}
+
 _postman_environment_lint() {
   _arguments \
     '(-f --fail-severity)'{-f,--fail-severity}'[Exit with failure if diagnostics at this level or above are present. \[choices\: "error", "warning"\] (default\: "error")]:value' \
@@ -427,6 +520,8 @@ _postman_spec() {
       case $words[1] in
         lint) _postman_spec_lint ;;
         ai-readiness) _postman_spec_ai_readiness ;;
+        list) _postman_spec_list ;;
+        get) _postman_spec_get ;;
       esac
       ;;
   esac
@@ -437,6 +532,8 @@ _postman_spec_commands() {
   sub=(
     'lint:Run linting on the given specification by ID or local file path.'
     'ai-readiness:Score an OpenAPI specification for AI readiness by ID or local file path.'
+    'list:List local spec files under a path, or (no path) a workspace'\''s cloud specs.'
+    'get:Read a spec definition, including every file of a multi-file spec.'
   )
   _describe -t commands 'spec command' sub
 }
@@ -460,6 +557,23 @@ _postman_spec_ai_readiness() {
     '*:spec:'
 }
 
+_postman_spec_list() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Workspace ID (defaults to .postman/resources.yaml binding)]:id' \
+    '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Output as JSON]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:pathOrDir:_files -g "*.json"'
+}
+
+_postman_spec_get() {
+  _arguments \
+    '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Output as JSON (full spec definition)]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:spec...:'
+}
+
 _postman_monitor() {
   local context state state_descr line
   typeset -A opt_args
@@ -1002,7 +1116,7 @@ _postman_mock() {
 _postman_mock_commands() {
   local -a sub
   sub=(
-    'generate:Generate a runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto-detected. Omit the source to scaffold a sample mock with a GET /health endpoint. Writes a local mock by default, or a cloud mock with --workspace.'
+    'generate:Generate a runnable mock from a Postman collection (v2.0/v2.1/v3 file, or a git-native v3 collection directory) or an OpenAPI 3.0/3.1 spec file. The source type is auto-detected. Omit the source to scaffold a sample shopping-cart mock (POST /cart/items, GET /cart, POST /checkout). Writes a local mock by default, or a cloud mock with --workspace.'
     'run:Start a local mock server from a cloud mock id (fetched and run locally), a manifest file (JSON or YAML), a mock directory (postman/mocks/<slug>), or a .js handler.'
     'deploy:Deploy a cloud mock into a mock server.'
     'get:Show a mock'\''s details\: a cloud mock by id, or a local mock by path.'
@@ -1416,6 +1530,53 @@ _postman_context_environment_get() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
+_postman_context_graph() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_context_graph_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        ask) _postman_context_graph_ask ;;
+        status) _postman_context_graph_status ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_context_graph_commands() {
+  local -a sub
+  sub=(
+    'ask:Ask a natural-language question about your team'\''s Context Graph.'
+    'status:Check an ask submitted by `ask`, without blocking. Prints the answer when ready.'
+  )
+  _describe -t commands 'context-graph command' sub
+}
+
+_postman_context_graph_ask() {
+  _arguments \
+    '--wait[Block until the answer arrives, then print it]' \
+    '--api-key[Postman API key (falls back to POSTMAN_API_KEY, then a `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Output the ask record as JSON]' \
+    '--no-include-answer[Do not ask the service to include the answer inline]' \
+    '--max-steps[Cap the reasoning steps the service may take (its default applies when omitted)]:count' \
+    '--interval[With --wait, seconds between polls (default\: 2)]:seconds' \
+    '--timeout[With --wait, seconds to wait before giving up (default\: 300)]:seconds' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:query:'
+}
+
+_postman_context_graph_status() {
+  _arguments \
+    '--api-key[Postman API key (falls back to POSTMAN_API_KEY, then a `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Output the ask record as JSON]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:askId:'
+}
+
 _postman_search() {
   local context state state_descr line
   typeset -A opt_args
@@ -1971,6 +2132,39 @@ _postman_dataset_view_update() {
     '*:viewNameOrId:'
 }
 
+_postman_dependency() {
+  local context state state_descr line
+  typeset -A opt_args
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '1: :_postman_dependency_commands' \
+    '*::arg:->args'
+  case $state in
+    args)
+      case $words[1] in
+        add) _postman_dependency_add ;;
+      esac
+      ;;
+  esac
+}
+
+_postman_dependency_commands() {
+  local -a sub
+  sub=(
+    'add:Add a Postman collection, environment, or mock as a workspace dependency.'
+  )
+  _describe -t commands 'dependency command' sub
+}
+
+_postman_dependency_add() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Workspace id to resolve a name in (defaults to the current workspace).]:id' \
+    '(-y --yes)'{-y,--yes}'[Skip all confirmation prompts.]' \
+    '--json[Output the result as JSON.]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:nameOrId:'
+}
+
 # When loaded via fpath + compinit, the file body becomes the function body of
 # `_postman`. In that case `funcstack[1]` is `_postman` and we must actually
 # invoke the completion. When sourced directly, this is a no-op — `_postman`

package/package.json

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