postman-cli-completion 1.46.1 → 1.48.0

package/completions/bash/postman.bash

@@ -1,4 +1,4 @@
-# Bash completion for Postman CLI (postman v1.46.1)
+# Bash completion for Postman CLI (postman v1.48.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -143,7 +143,7 @@ _postman_collection_ai_readiness() {
 
 _postman_collection_run() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-e --environment -g --globals -r --reporters --output --reporter-json-structure -n --iteration-count -d --iteration-data --iteration-data-dataset --iteration-data-view --dataset -i --global-var --env-var --integration-id --postman-api-key --alias --bail --ignore-redirects -x --suppress-exit-code --silent --disable-unicode --delay-request --timeout --timeout-request --timeout-script --working-dir --no-insecure-file-read -k --insecure --ssl-client-cert-list --ssl-client-cert --ssl-client-key --ssl-client-passphrase --ssl-extra-ca-certs --cookie-jar --export-cookie-jar --verbose --mock --simulate --report-events -h --help --reporter-json-export --reporter-junit-export --reporter-html-export --reporter-json-omitRequestBodies --reporter-html-omitRequestBodies --reporter-json-omitResponseBodies --reporter-html-omitResponseBodies --reporter-json-omitHeaders --reporter-html-omitHeaders --reporter-json-omitAllHeadersAndBody --reporter-html-omitAllHeadersAndBody" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-e --environment -g --globals -r --reporters --output --reporter-json-structure -n --iteration-count -d --iteration-data --iteration-data-dataset --iteration-data-view --dataset -i --global-var --env-var --integration-id --postman-api-key --alias --bail --ignore-redirects -x --suppress-exit-code --silent --disable-unicode --delay-request --timeout --timeout-request --timeout-script --working-dir --no-insecure-file-read -k --insecure --ssl-client-cert-list --ssl-client-cert --ssl-client-key --ssl-client-passphrase --ssl-extra-ca-certs --cookie-jar --export-cookie-jar --verbose --mock --port --simulate --report-events -h --help --reporter-json-export --reporter-junit-export --reporter-html-export --reporter-json-omitRequestBodies --reporter-html-omitRequestBodies --reporter-json-omitResponseBodies --reporter-html-omitResponseBodies --reporter-json-omitHeaders --reporter-html-omitHeaders --reporter-json-omitAllHeadersAndBody --reporter-html-omitAllHeadersAndBody" -- "$cur") )
     return 0
   fi
   case "$prev" in
@@ -382,7 +382,7 @@ _postman_workspace() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "list prepare push" -- "$cur") )
+      COMPREPLY=( $(compgen -W "list prepare push lint" -- "$cur") )
     fi
     return 0
   fi
@@ -390,6 +390,7 @@ _postman_workspace() {
     list) _postman_workspace_list ;;
     prepare) _postman_workspace_prepare ;;
     push) _postman_workspace_push ;;
+    lint) _postman_workspace_lint ;;
   esac
 }
 
@@ -418,6 +419,15 @@ _postman_workspace_push() {
   esac
 }
 
+_postman_workspace_lint() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-f --fail-severity -o --output --meta --workspace-id -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+  esac
+}
+
 _postman_performance() {
   if [[ -z "$subcmd" ]]; then
     if [[ "$cur" == -* ]]; then
@@ -692,18 +702,34 @@ _postman_mock() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "run" -- "$cur") )
+      COMPREPLY=( $(compgen -W "generate run" -- "$cur") )
     fi
     return 0
   fi
   case "$subcmd" in
+    generate) _postman_mock_generate ;;
     run) _postman_mock_run ;;
   esac
 }
 
+_postman_mock_generate() {
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "-o --output --name --port --force -u --update -x --suppress-exit-code -h --help" -- "$cur") )
+    return 0
+  fi
+  case "$prev" in
+    -o|--output)
+      _postman_filematch '!*.@(json)' "$cur"
+      return 0 ;;
+    -u|--update)
+      _postman_filematch '!*.@(json)' "$cur"
+      return 0 ;;
+  esac
+}
+
 _postman_mock_run() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-e --environment -g --globals -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-e --environment -g --globals -p --port -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
@@ -742,7 +768,7 @@ _postman_application_init() {
 
 _postman_application_test() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--target --target-collection --target-environment --command --network-log --capture-only --output --force --report-events --verbose -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "--target --target-collection --target-environment --command --deployed-version --network-log --capture-only --output --force --report-events --verbose -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in

package/completions/fish/postman.fish

@@ -1,4 +1,4 @@
-# Fish completion for Postman CLI (postman v1.46.1)
+# Fish completion for Postman CLI (postman v1.48.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -115,6 +115,7 @@ 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' -l export-cookie-jar -d 'Exports the cookie jar to a file after completing the run' -r
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l verbose -d 'Show detailed information of collection run and each request sent'
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l mock -d 'Start a mock server from manifest (.json, .yaml or .yml) file' -r
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l port -d 'Port for the --mock server; pass "auto" for an OS-assigned ephemeral port (default: configured port, falls back to an ephemeral one if busy). Only valid with --mock.' -x
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l simulate -d 'Start mock servers with fault-injection scenarios from a .sim.yaml file' -r
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l report-events -d 'Send run results and analytics to Postman'
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
@@ -207,9 +208,10 @@ 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' -a list -d 'List all available Postman Workspaces'
-complete -c postman -n '__postman_using_subcommand workspace list prepare push' -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' -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' -a list -d 'List all available Postman Workspaces'
+complete -c postman -n '__postman_using_subcommand workspace list prepare push lint' -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' -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' -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 '__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
@@ -228,6 +230,12 @@ 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 push' -l verbose -d 'Show detailed logging'
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from push' -l report-events -d 'Send workspace push events to Postman'
 complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from push' -s h -l help -d 'display help for command'
+# ---------- workspace lint ----------
+complete -c postman -n '__fish_seen_subcommand_from workspace; 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", "info", "hint"] (default: "error")' -x
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -s o -l output -d 'Output format: cli (human-readable), table, or json. (default: "cli")' -x
+complete -c postman -n '__fish_seen_subcommand_from workspace; and __fish_seen_subcommand_from lint' -l meta -d 'Only lint the workspace configuration (.postman/resources.yaml); skip per-entity linting.'
+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' -s h -l help -d 'display help for command'
 
 # ---------- performance ----------
 complete -c postman -n '__postman_using_subcommand performance run' -a run -d 'Run a performance test on a collection'
@@ -446,11 +454,21 @@ 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 run' -a run -d 'Start a local mock server given a manifest file (JSON or YAML).'
+complete -c postman -n '__postman_using_subcommand mock generate run' -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.'
+complete -c postman -n '__postman_using_subcommand mock generate run' -a run -d 'Start a local mock server given a manifest file (JSON or YAML).'
 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
+complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from generate' -l name -d 'Display name for the generated mock' -x
+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 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' -s h -l help -d 'display help for command'
 
 # ---------- application ----------
@@ -470,6 +488,7 @@ complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen
 complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l target-collection -d 'Collection override for the selected target (repeatable) (default: [])' -r
 complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l target-environment -d 'Environment override for the selected target (last value wins) (default: [])' -r
 complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l command -d 'Command to run first (primary task). Overrides config.' -x
+complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l deployed-version -d 'Version identity of the application under test (e.g. a build ID, release tag, or version string). Also read from the APP_DEPLOYED_VERSION environment variable.' -x
 complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l network-log -d 'Directory to scan for captured artifacts, or a direct path to a Playwright JSON report / NDJSON capture file. When a directory is given, recursively discovers `*.json` Playwright reports plus their `trace.zip` attachments, and `network-capture-*.ndjson` at the top level. By default, scans Playwright config `outputDir`, test-results/, then pm-results/.' -r
 complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l capture-only -d 'Skip collection matching and tests; capture traffic and save a V3 collection organised by host'
 complete -c postman -n '__fish_seen_subcommand_from application; and __fish_seen_subcommand_from test' -l output -d 'Output directory for captured collection (default: pm-results/captured/; used with --capture-only)' -r

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.46.1)
+# Zsh completion for Postman CLI (postman v1.48.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -184,6 +184,7 @@ _postman_collection_run() {
     '--export-cookie-jar[Exports the cookie jar to a file after completing the run]:path:_files -g "*.json"' \
     '--verbose[Show detailed information of collection run and each request sent]' \
     '--mock[Start a mock server from manifest (.json, .yaml or .yml) file]:path:_files -g "*.json"' \
+    '--port[Port for the --mock server; pass "auto" for an OS-assigned ephemeral port (default\: configured port, falls back to an ephemeral one if busy). Only valid with --mock.]:port' \
     '--simulate[Start mock servers with fault-injection scenarios from a .sim.yaml file]:path:_files -g "*.(sim.yaml|yaml|yml)"' \
     '--report-events[Send run results and analytics to Postman]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
@@ -440,6 +441,7 @@ _postman_workspace() {
         list) _postman_workspace_list ;;
         prepare) _postman_workspace_prepare ;;
         push) _postman_workspace_push ;;
+        lint) _postman_workspace_lint ;;
       esac
       ;;
   esac
@@ -451,6 +453,7 @@ _postman_workspace_commands() {
     'list:List all available Postman Workspaces'
     '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.'
   )
   _describe -t commands 'workspace command' sub
 }
@@ -481,6 +484,15 @@ _postman_workspace_push() {
     '(-h --help)'{-h,--help}'[display help for command]'
 }
 
+_postman_workspace_lint() {
+  _arguments \
+    '(-f --fail-severity)'{-f,--fail-severity}'[Exit with failure if diagnostics at this level or above are present. \[choices\: "error", "warning", "info", "hint"\] (default\: "error")]:value' \
+    '(-o --output)'{-o,--output}'[Output format\: cli (human-readable), table, or json. (default\: "cli")]:value' \
+    '--meta[Only lint the workspace configuration (.postman/resources.yaml); skip per-entity linting.]' \
+    '--workspace-id[The workspace ID to use for fetching governance rulesets. Defaults to the id in .postman/resources.yaml.]:value' \
+    '(-h --help)'{-h,--help}'[display help for command]'
+}
+
 _postman_performance() {
   local context state state_descr line
   typeset -A opt_args
@@ -861,6 +873,7 @@ _postman_mock() {
   case $state in
     args)
       case $words[1] in
+        generate) _postman_mock_generate ;;
         run) _postman_mock_run ;;
       esac
       ;;
@@ -870,15 +883,29 @@ _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.'
     'run:Start a local mock server given a manifest file (JSON or YAML).'
   )
   _describe -t commands 'mock command' sub
 }
 
+_postman_mock_generate() {
+  _arguments \
+    '(-o --output)'{-o,--output}'[Output directory for the mock (default\: postman/mocks/<slug>)]:dir:_files -g "*.json"' \
+    '--name[Display name for the generated mock]:name' \
+    '--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"' \
+    '(-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:'
+}
+
 _postman_mock_run() {
   _arguments \
     '(-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' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:manifestPath:'
 }
@@ -926,6 +953,7 @@ _postman_application_test() {
     '--target-collection[Collection override for the selected target (repeatable) (default\: \[\])]:path:_files -g "*.json"' \
     '--target-environment[Environment override for the selected target (last value wins) (default\: \[\])]:path:_files -g "*.json"' \
     '--command[Command to run first (primary task). Overrides config.]:cmd' \
+    '--deployed-version[Version identity of the application under test (e.g. a build ID, release tag, or version string). Also read from the APP_DEPLOYED_VERSION environment variable.]:version' \
     '--network-log[Directory to scan for captured artifacts, or a direct path to a Playwright JSON report / NDJSON capture file. When a directory is given, recursively discovers `*.json` Playwright reports plus their `trace.zip` attachments, and `network-capture-*.ndjson` at the top level. By default, scans Playwright config `outputDir`, test-results/, then pm-results/.]:path:_files -g "*.json"' \
     '--capture-only[Skip collection matching and tests; capture traffic and save a V3 collection organised by host]' \
     '--output[Output directory for captured collection (default\: pm-results/captured/; used with --capture-only)]:path:_files -g "*.json"' \

package/package.json

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