postman-cli-completion 1.52.0 → 1.54.2

package/completions/bash/postman.bash

@@ -1,4 +1,4 @@
-# Bash completion for Postman CLI (postman v1.52.0)
+# Bash completion for Postman CLI (postman v1.54.2)
 # 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 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 logout init collection environment globals api runner spec monitor workspace ws performance flows fl request sdk mock application app simulate context search webhook dataset"
   local global_flags="-v --version --silent --color -h --help -h --help"
 
   local i cmd="" subcmd=""
@@ -48,6 +48,7 @@ _postman() {
   case "$cmd" in
     login) _postman_login ;;
     logout) _postman_logout ;;
+    init) _postman_init ;;
     collection) _postman_collection ;;
     environment) _postman_environment ;;
     globals) _postman_globals ;;
@@ -91,6 +92,19 @@ _postman_logout() {
   esac
 }
 
+_postman_init() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--json --dry-run --no-seed --spec --visibility --no-cloud --report-events -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    --spec)
+      _postman_filematch '!*.@(yaml|yml|json)' "$cur"
+      return 0 ;;
+  esac
+  _postman_filematch '!*.@(json)' "$cur"
+}
+
 _postman_collection() {
   if [[ -z "$subcmd" ]]; then
     if [[ "$cur" == -* ]]; then
@@ -382,7 +396,7 @@ _postman_workspace() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "list prepare push lint pull connect-git" -- "$cur") )
+      COMPREPLY=( $(compgen -W "list prepare push lint create pull connect-git" -- "$cur") )
     fi
     return 0
   fi
@@ -391,6 +405,7 @@ _postman_workspace() {
     prepare) _postman_workspace_prepare ;;
     push) _postman_workspace_push ;;
     lint) _postman_workspace_lint ;;
+    create) _postman_workspace_create ;;
     pull) _postman_workspace_pull ;;
     connect-git) _postman_workspace_connect_git ;;
   esac
@@ -430,6 +445,18 @@ _postman_workspace_lint() {
   esac
 }
 
+_postman_workspace_create() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--visibility --name --summary --path --no-connect --force -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    --path)
+      _postman_filematch '!*.@(json)' "$cur"
+      return 0 ;;
+  esac
+}
+
 _postman_workspace_pull() {
   if [[ "$cur" == -* ]]; then
     COMPREPLY=( $(compgen -W "-y --yes --source-workspace --verbose -h --help" -- "$cur") )
@@ -463,7 +490,7 @@ _postman_performance() {
 
 _postman_performance_run() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-e --environment -g --globals --vu-count -d --duration -p --load-profile --data-file --dataset-id --dataset-view-id --dataset-distribution --postman-api-key --runner --pass-if -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-e --environment -g --globals --setup-collection --teardown-collection --vu-count -d --duration -p --load-profile --data-file --dataset-id --dataset-view-id --dataset-distribution --postman-api-key --runner --pass-if -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
@@ -724,22 +751,24 @@ _postman_mock() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "generate run get list delete" -- "$cur") )
+      COMPREPLY=( $(compgen -W "generate run deploy get list log delete" -- "$cur") )
     fi
     return 0
   fi
   case "$subcmd" in
     generate) _postman_mock_generate ;;
     run) _postman_mock_run ;;
+    deploy) _postman_mock_deploy ;;
     get) _postman_mock_get ;;
     list) _postman_mock_list ;;
+    log) _postman_mock_log ;;
     delete) _postman_mock_delete ;;
   esac
 }
 
 _postman_mock_generate() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-o --output -n --name --port --force -u --update -x --suppress-exit-code -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-o --output -n --name --port --force -u --update -w --workspace --api-key -x --suppress-exit-code -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
@@ -749,12 +778,15 @@ _postman_mock_generate() {
     -u|--update)
       _postman_filematch '!*.@(json)' "$cur"
       return 0 ;;
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
   esac
 }
 
 _postman_mock_run() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-e --environment -g --globals -p --port -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-e --environment -g --globals -p --port --api-key -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
@@ -764,31 +796,75 @@ _postman_mock_run() {
     -g|--globals)
       _postman_filematch '!*.@(json)' "$cur"
       return 0 ;;
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
+  _postman_filematch '!*.@(json)' "$cur"
+}
+
+_postman_mock_deploy() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-w --workspace -n --name -s --slug --public --auto-deploy -y --yes --api-key -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_mock_get() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--json -h --help" -- "$cur") )
+    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_filematch '!*.@(json)' "$cur"
 }
 
 _postman_mock_list() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--json -h --help" -- "$cur") )
+    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_mock_log() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "--limit --method --status --path --since --until --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_mock_delete() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-y --yes -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-y --yes --api-key -h --help" -- "$cur") )
     return 0
   fi
+  case "$prev" in
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
+      return 0 ;;
+  esac
   _postman_filematch '!*.@(json)' "$cur"
 }
 

package/completions/fish/postman.fish

@@ -1,10 +1,10 @@
-# Fish completion for Postman CLI (postman v1.52.0)
+# Fish completion for Postman CLI (postman v1.54.2)
 # 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 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 logout init collection environment globals api runner spec monitor workspace ws performance flows fl request sdk mock application app simulate context search webhook dataset
 end
 
 function __postman_using_subcommand
@@ -23,6 +23,7 @@ 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 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 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 globals -d 'Work with local Postman globals from the command line.'
@@ -37,7 +38,7 @@ complete -c postman -n __postman_no_subcommand -a flows -d 'Manage and interact
 complete -c postman -n __postman_no_subcommand -a fl -d 'Alias for flows'
 complete -c postman -n __postman_no_subcommand -a request -d 'Send HTTP requests from the command line with full Postman capabilities including authentication, environment variables, assertions, retries, and detailed output control.'
 complete -c postman -n __postman_no_subcommand -a sdk -d 'Generate and manage your SDKs directly from the command line.'
-complete -c postman -n __postman_no_subcommand -a mock -d 'Run and manage local Postman mock servers.'
+complete -c postman -n __postman_no_subcommand -a mock -d 'Run and manage Postman mocks, locally and in the cloud.'
 complete -c postman -n __postman_no_subcommand -a application -d 'Application-level commands: initialise config and run tests.'
 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.'
@@ -57,6 +58,17 @@ complete -c postman -n '__fish_seen_subcommand_from login' -s h -l help -d 'disp
 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'
 
+# ---------- init ----------
+complete -c postman -n '__fish_seen_subcommand_from init' -l json -d 'Emit machine-readable output for agents'
+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-seed -d 'Do not derive a spec from source'
+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 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'
+complete -c postman -n '__fish_seen_subcommand_from init' -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.'
@@ -212,12 +224,13 @@ 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 run' -s h -l help -d 'display help for command'
 
 # ---------- workspace ----------
-complete -c postman -n '__postman_using_subcommand workspace list prepare push lint pull connect-git' -a list -d 'List all available Postman Workspaces'
-complete -c postman -n '__postman_using_subcommand workspace list prepare push lint 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 pull connect-git' -a push -d 'Push local workspace entities (collections, environments, specifications, and more) to Postman workspace.'
-complete -c postman -n '__postman_using_subcommand workspace list prepare push lint 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 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 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' -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, 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 '__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
@@ -244,6 +257,14 @@ 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 lint' -l workspace-id -d 'The workspace ID to use for fetching governance rulesets. Defaults to the id in .postman/resources.yaml.' -x
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -l fix -d 'Apply safe autofixes to repairable workspace lint issues.'
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -s h -l help -d 'display help for command'
+# ---------- workspace create ----------
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from create' -l visibility -d 'Required. Workspace visibility, e.g. personal or team' -x
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from create' -l name -d 'Workspace name (defaults to owner/repo from the git remote)' -x
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from create' -l summary -d 'Optional workspace summary' -x
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from create' -l path -d 'Directory to bind (defaults to the current directory)' -r
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from create' -l no-connect -d 'Create the workspace without binding it to the repository'
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from create' -l force -d 'Create even when a workspace is already recorded for this repo'
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from create' -s h -l help -d 'display help for command'
 # ---------- workspace pull ----------
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from pull' -s y -l yes -d 'Skip all confirmation prompts'
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from pull' -l source-workspace -d 'Pull from a different source workspace.' -x
@@ -260,6 +281,8 @@ complete -c postman -n '__fish_seen_subcommand_from performance' -s h -l help -d
 # ---------- 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
 complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s g -l globals -d 'Specify an Id to a Postman Globals' -x
+complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l setup-collection -d 'Collection UID to run before the Postman Cloud performance test' -x
+complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l teardown-collection -d 'Collection UID to run after the Postman Cloud performance test' -x
 complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l vu-count -d 'Number of virtual users (default: 20)' -x
 complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s d -l duration -d 'Duration of the performance test in minutes (default: 1)' -x
 complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s p -l load-profile -d 'Load profile type: fixed, ramp-up, spike, peak (default: "ramp-up")' -x
@@ -483,11 +506,13 @@ 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 get list delete' -a generate -d 'Generate a local, 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.'
-complete -c postman -n '__postman_using_subcommand mock generate run get list delete' -a run -d 'Start a local mock server given 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 get list delete' -a get -d 'Show a local mock\'s details and run status.'
-complete -c postman -n '__postman_using_subcommand mock generate run get list delete' -a list -d 'List local mocks found under a directory.'
-complete -c postman -n '__postman_using_subcommand mock generate run get list delete' -a delete -d 'Permanently remove a local mock artifact.'
+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 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.'
+complete -c postman -n '__postman_using_subcommand mock generate run deploy get list log delete' -a list -d 'List a workspace\'s cloud mocks, or (with a path) local mocks under a directory.'
+complete -c postman -n '__postman_using_subcommand mock generate run deploy get list log delete' -a log -d 'Browse a deployed mock server\'s request/response logs by its id (see `mock get`).'
+complete -c postman -n '__postman_using_subcommand mock generate run deploy get list log delete' -a delete -d 'Permanently remove a mock: a cloud mock by id, or a local mock artifact by path.'
 complete -c postman -n '__fish_seen_subcommand_from mock' -s h -l help -d 'display help for command'
 # ---------- mock generate ----------
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -s o -l output -d 'Output directory for the mock (default: postman/mocks/<slug>)' -r
@@ -495,24 +520,52 @@ 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' -l port -d 'Port the mock server should listen on (default: 4500)' -x
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -l force -d 'Overwrite the config.yaml/default.js in the output directory if it already exists'
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -s u -l update -d 'Update an existing mock in place from the source: path to its config.yaml (or the directory containing it). Regenerates the default scenario handler and preserves the existing name/port/scenarios. Cannot be combined with --output.' -r
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -s w -l workspace -d 'Create a cloud mock in this Postman workspace instead of a local mock. Cannot be combined with --output/--force/--update.' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -l api-key -d 'Postman API key for --workspace (defaults to the `postman login` session)' -r
 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 an environment file (JSON or YAML) for pm.environment' -r
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s g -l globals -d 'Path to a globals file (JSON or YAML) for pm.globals' -r
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s p -l port -d 'Mock server port, or "auto" for an ephemeral one (default: configured port, falls back to an ephemeral one if busy).' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -l api-key -d 'Postman API key for cloud mock ids (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
+# ---------- mock deploy ----------
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from deploy' -s w -l workspace -d 'Workspace that will own the mock server (defaults to the workspace linked in .postman/resources.yaml)' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from deploy' -s n -l name -d 'Display name for the mock server (prompts when omitted)' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from deploy' -s s -l slug -d 'Slug for the deploy URL (prompts when omitted)' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from deploy' -l public -d 'Deploy as a public mock (default is private; requires an x-api-key header)'
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from deploy' -l auto-deploy -d 'Re-deploy the mock automatically whenever it changes (default off)'
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from deploy' -s y -l yes -d 'Accept defaults and skip all prompts (private, no auto-deploy)'
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from deploy' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from deploy' -s h -l help -d 'display help for command'
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from deploy' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- mock get ----------
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from get' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from get' -l json -d 'Output the mock details as JSON instead of a table'
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from get' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- mock list ----------
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from list' -s w -l workspace -d 'Workspace whose cloud mocks to list (defaults to the workspace linked in .postman/resources.yaml)' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from list' -l json -d 'Output the mock list as JSON instead of a table'
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from list' -r -k -a '(__fish_complete_suffix .json)'
+# ---------- mock log ----------
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from log' -l limit -d 'Maximum number of log entries to show (default 50 for --json/non-interactive output)' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from log' -l method -d 'Filter by HTTP method (e.g. GET, POST)' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from log' -l status -d 'Filter by response status (e.g. 404 or 5xx)' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from log' -l path -d 'Filter by request path (supports * and ? wildcards)' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from log' -l since -d 'Show logs from this long ago onward (e.g. 2h = the last 2 hours)' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from log' -l until -d 'Stop this long ago (e.g. 30m = exclude the most recent 30 minutes)' -x
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from log' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from log' -l json -d 'Output logs as JSON instead of the interactive pager'
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from log' -s h -l help -d 'display help for command'
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from log' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- mock delete ----------
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from delete' -s y -l yes -d 'Skip the confirmation prompt'
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from delete' -l api-key -d 'Postman API key for cloud mock ids (defaults to the `postman login` session)' -r
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from delete' -r -k -a '(__fish_complete_suffix .json)'
 

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.52.0)
+# Zsh completion for Postman CLI (postman v1.54.2)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -22,6 +22,7 @@ _postman() {
       case $words[1] in
         login) _postman_login ;;
         logout) _postman_logout ;;
+        init) _postman_init ;;
         collection) _postman_collection ;;
         environment) _postman_environment ;;
         globals) _postman_globals ;;
@@ -51,6 +52,7 @@ _postman_commands() {
   commands=(
     'login:Authenticate with Postman to access your resources.'
     'logout:Delete the stored Postman API key.'
+    'init:Set up Postman artifacts and agent instructions in a repository.'
     'collection:Run and test your Postman collections directly from the command line.'
     'environment:Work with local Postman environments from the command line.'
     'globals:Work with local Postman globals from the command line.'
@@ -65,7 +67,7 @@ _postman_commands() {
     'fl:Alias for flows'
     'request:Send HTTP requests from the command line with full Postman capabilities including authentication, environment variables, assertions, retries, and detailed output control.'
     'sdk:Generate and manage your SDKs directly from the command line.'
-    'mock:Run and manage local Postman mock servers.'
+    'mock:Run and manage Postman mocks, locally and in the cloud.'
     'application:Application-level commands\: initialise config and run tests.'
     'app:Alias for application'
     'simulate:Start mock servers with simulated failure scenarios.'
@@ -92,6 +94,19 @@ _postman_logout() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
+_postman_init() {
+  _arguments \
+    '--json[Emit machine-readable output for agents]' \
+    '--dry-run[Report what would happen without writing anything]' \
+    '--no-seed[Do not derive a spec from source]' \
+    '--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' \
+    '--no-cloud[Skip the workspace step entirely]' \
+    '--report-events[Send init analytics to Postman (requires login)]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:path:_files -g "*.json"'
+}
+
 _postman_collection() {
   local context state state_descr line
   typeset -A opt_args
@@ -446,6 +461,7 @@ _postman_workspace() {
         prepare) _postman_workspace_prepare ;;
         push) _postman_workspace_push ;;
         lint) _postman_workspace_lint ;;
+        create) _postman_workspace_create ;;
         pull) _postman_workspace_pull ;;
         connect-git) _postman_workspace_connect_git ;;
       esac
@@ -460,6 +476,7 @@ _postman_workspace_commands() {
     'prepare:Prepare local collections and environments for push by validating and regenerating IDs if needed.'
     'push:Push local workspace entities (collections, environments, specifications, and more) to Postman workspace.'
     'lint:Lint the current local Postman workspace\: its configuration (.postman/resources.yaml) plus every discovered entity. Use --meta to lint only the configuration.'
+    '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.'
   )
@@ -503,6 +520,17 @@ _postman_workspace_lint() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
+_postman_workspace_create() {
+  _arguments \
+    '--visibility[Required. Workspace visibility, e.g. personal or team]:status' \
+    '--name[Workspace name (defaults to owner/repo from the git remote)]:name' \
+    '--summary[Optional workspace summary]:text' \
+    '--path[Directory to bind (defaults to the current directory)]:dir:_files -g "*.json"' \
+    '--no-connect[Create the workspace without binding it to the repository]' \
+    '--force[Create even when a workspace is already recorded for this repo]' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 _postman_workspace_pull() {
   _arguments \
     '(-y --yes)'{-y,--yes}'[Skip all confirmation prompts]' \
@@ -547,6 +575,8 @@ _postman_performance_run() {
   _arguments \
     '(-e --environment)'{-e,--environment}'[Specify an Id to a Postman Environment]:id' \
     '(-g --globals)'{-g,--globals}'[Specify an Id to a Postman Globals]:id' \
+    '--setup-collection[Collection UID to run before the Postman Cloud performance test]:id' \
+    '--teardown-collection[Collection UID to run after the Postman Cloud performance test]:id' \
     '--vu-count[Number of virtual users (default\: 20)]:count' \
     '(-d --duration)'{-d,--duration}'[Duration of the performance test in minutes (default\: 1)]:minutes' \
     '(-p --load-profile)'{-p,--load-profile}'[Load profile type\: fixed, ramp-up, spike, peak (default\: "ramp-up")]:profile' \
@@ -913,8 +943,10 @@ _postman_mock() {
       case $words[1] in
         generate) _postman_mock_generate ;;
         run) _postman_mock_run ;;
+        deploy) _postman_mock_deploy ;;
         get) _postman_mock_get ;;
         list) _postman_mock_list ;;
+        log) _postman_mock_log ;;
         delete) _postman_mock_delete ;;
       esac
       ;;
@@ -924,11 +956,13 @@ _postman_mock() {
 _postman_mock_commands() {
   local -a sub
   sub=(
-    'generate:Generate a local, 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.'
-    'run:Start a local mock server given a manifest file (JSON or YAML), a mock directory (postman/mocks/<slug>), or a .js handler.'
-    'get:Show a local mock'\''s details and run status.'
-    'list:List local mocks found under a directory.'
-    'delete:Permanently remove a local mock artifact.'
+    '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.'
+    '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.'
+    'list:List a workspace'\''s cloud mocks, or (with a path) local mocks under a directory.'
+    'log:Browse a deployed mock server'\''s request/response logs by its id (see `mock get`).'
+    'delete:Permanently remove a mock\: a cloud mock by id, or a local mock artifact by path.'
   )
   _describe -t commands 'mock command' sub
 }
@@ -940,6 +974,8 @@ _postman_mock_generate() {
     '--port[Port the mock server should listen on (default\: 4500)]:port' \
     '--force[Overwrite the config.yaml/default.js in the output directory if it already exists]' \
     '(-u --update)'{-u,--update}'[Update an existing mock in place from the source\: path to its config.yaml (or the directory containing it). Regenerates the default scenario handler and preserves the existing name/port/scenarios. Cannot be combined with --output.]:mockPath:_files -g "*.json"' \
+    '(-w --workspace)'{-w,--workspace}'[Create a cloud mock in this Postman workspace instead of a local mock. Cannot be combined with --output/--force/--update.]:id' \
+    '--api-key[Postman API key for --workspace (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-x --suppress-exit-code)'{-x,--suppress-exit-code}'[Always exit with code 0, even on failure]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:sourcePath:'
@@ -950,29 +986,61 @@ _postman_mock_run() {
     '(-e --environment)'{-e,--environment}'[Path to an environment file (JSON or YAML) for pm.environment]:path:_files -g "*.json"' \
     '(-g --globals)'{-g,--globals}'[Path to a globals file (JSON or YAML) for pm.globals]:path:_files -g "*.json"' \
     '(-p --port)'{-p,--port}'[Mock server port, or "auto" for an ephemeral one (default\: configured port, falls back to an ephemeral one if busy).]:port' \
+    '--api-key[Postman API key for cloud mock ids (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:pathOrDir:_files -g "*.json"'
+    '*:mockIdOrPath:_files -g "*.json"'
+}
+
+_postman_mock_deploy() {
+  _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Workspace that will own the mock server (defaults to the workspace linked in .postman/resources.yaml)]:id' \
+    '(-n --name)'{-n,--name}'[Display name for the mock server (prompts when omitted)]:name' \
+    '(-s --slug)'{-s,--slug}'[Slug for the deploy URL (prompts when omitted)]:slug' \
+    '--public[Deploy as a public mock (default is private; requires an x-api-key header)]' \
+    '--auto-deploy[Re-deploy the mock automatically whenever it changes (default off)]' \
+    '(-y --yes)'{-y,--yes}'[Accept defaults and skip all prompts (private, no auto-deploy)]' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:mockId:_files -g "*.json"'
 }
 
 _postman_mock_get() {
   _arguments \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '--json[Output the mock details as JSON instead of a table]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:pathOrDir:_files -g "*.json"'
+    '*:mockIdOrPath:_files -g "*.json"'
 }
 
 _postman_mock_list() {
   _arguments \
+    '(-w --workspace)'{-w,--workspace}'[Workspace whose cloud mocks to list (defaults to the workspace linked in .postman/resources.yaml)]:id' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '--json[Output the mock list as JSON instead of a table]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:pathOrDir:_files -g "*.json"'
 }
 
+_postman_mock_log() {
+  _arguments \
+    '--limit[Maximum number of log entries to show (default 50 for --json/non-interactive output)]:n' \
+    '--method[Filter by HTTP method (e.g. GET, POST)]:method' \
+    '--status[Filter by response status (e.g. 404 or 5xx)]:code|range' \
+    '--path[Filter by request path (supports * and ? wildcards)]:pattern' \
+    '--since[Show logs from this long ago onward (e.g. 2h = the last 2 hours)]:duration' \
+    '--until[Stop this long ago (e.g. 30m = exclude the most recent 30 minutes)]:duration' \
+    '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Output logs as JSON instead of the interactive pager]' \
+    '(-h --help)'{-h,--help}'[display help for command]' \
+    '*:mockServerId:_files -g "*.json"'
+}
+
 _postman_mock_delete() {
   _arguments \
     '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt]' \
+    '--api-key[Postman API key for cloud mock ids (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:pathOrDir:_files -g "*.json"'
+    '*:mockIdOrPath:_files -g "*.json"'
 }
 
 _postman_application() {

package/package.json

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