postman-cli-completion 1.65.0 → 1.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- # Bash completion for Postman CLI (postman v1.65.0)
1
+ # Bash completion for Postman CLI (postman v1.67.0)
2
2
  # Auto-generated by scripts/generate.mjs — DO NOT EDIT
3
3
  # Source: spec/commands.json
4
4
  # https://github.com/yokawasa/postman-cli-completion
@@ -179,7 +179,7 @@ _postman_collection() {
179
179
  if [[ "$cur" == -* ]]; then
180
180
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
181
181
  else
182
- COMPREPLY=( $(compgen -W "new migrate lint ai-readiness get generate sync request folder list run" -- "$cur") )
182
+ COMPREPLY=( $(compgen -W "new migrate lint get publish generate sync request folder list run" -- "$cur") )
183
183
  fi
184
184
  return 0
185
185
  fi
@@ -187,8 +187,8 @@ _postman_collection() {
187
187
  new) _postman_collection_new ;;
188
188
  migrate) _postman_collection_migrate ;;
189
189
  lint) _postman_collection_lint ;;
190
- ai-readiness) _postman_collection_ai_readiness ;;
191
190
  get) _postman_collection_get ;;
191
+ publish) _postman_collection_publish ;;
192
192
  generate) _postman_collection_generate ;;
193
193
  sync) _postman_collection_sync ;;
194
194
  request) _postman_collection_request ;;
@@ -230,29 +230,32 @@ _postman_collection_lint() {
230
230
  _postman_filematch '!*.@(json)' "$cur"
231
231
  }
232
232
 
233
- _postman_collection_ai_readiness() {
233
+ _postman_collection_get() {
234
234
  if [[ "$cur" == -* ]]; then
235
- COMPREPLY=( $(compgen -W "-o --output --export --min-score -h --help" -- "$cur") )
235
+ COMPREPLY=( $(compgen -W "--api-key --json -h --help" -- "$cur") )
236
236
  return 0
237
237
  fi
238
238
  case "$prev" in
239
- --export)
240
- _postman_filematch '!*.@(json)' "$cur"
239
+ --api-key)
240
+ _postman_filematch '!*.@(pem|crt|key)' "$cur"
241
241
  return 0 ;;
242
242
  esac
243
- _postman_filematch '!*.@(json)' "$cur"
244
243
  }
245
244
 
246
- _postman_collection_get() {
245
+ _postman_collection_publish() {
247
246
  if [[ "$cur" == -* ]]; then
248
- COMPREPLY=( $(compgen -W "--api-key --json -h --help" -- "$cur") )
247
+ COMPREPLY=( $(compgen -W "--target --environment --title --description --note --api-key --json -h --help" -- "$cur") )
249
248
  return 0
250
249
  fi
251
250
  case "$prev" in
251
+ --environment)
252
+ _postman_filematch '!*.@(json)' "$cur"
253
+ return 0 ;;
252
254
  --api-key)
253
255
  _postman_filematch '!*.@(pem|crt|key)' "$cur"
254
256
  return 0 ;;
255
257
  esac
258
+ _postman_filematch '!*.@(json)' "$cur"
256
259
  }
257
260
 
258
261
  _postman_collection_generate() {
@@ -336,7 +339,7 @@ _postman_collection_request_add() {
336
339
 
337
340
  _postman_collection_request_update() {
338
341
  if [[ "$cur" == -* ]]; then
339
- COMPREPLY=( $(compgen -W "--collection --folder --rename --url --method --param -d --body --variables --description --headers --auth --scripts -w --workspace --type --json -h --help" -- "$cur") )
342
+ COMPREPLY=( $(compgen -W "--collection --folder --rename --url --method --param --clear-params -d --body --variables --description --headers --auth --scripts -w --workspace --type --json -h --help" -- "$cur") )
340
343
  return 0
341
344
  fi
342
345
  case "$prev" in
@@ -708,19 +711,19 @@ _postman_spec() {
708
711
  if [[ "$cur" == -* ]]; then
709
712
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
710
713
  else
711
- COMPREPLY=( $(compgen -W "lint ai-readiness list get file create generate sync" -- "$cur") )
714
+ COMPREPLY=( $(compgen -W "lint list get file create generate sync delete" -- "$cur") )
712
715
  fi
713
716
  return 0
714
717
  fi
715
718
  case "$subcmd" in
716
719
  lint) _postman_spec_lint ;;
717
- ai-readiness) _postman_spec_ai_readiness ;;
718
720
  list) _postman_spec_list ;;
719
721
  get) _postman_spec_get ;;
720
722
  file) _postman_spec_file ;;
721
723
  create) _postman_spec_create ;;
722
724
  generate) _postman_spec_generate ;;
723
725
  sync) _postman_spec_sync ;;
726
+ delete) _postman_spec_delete ;;
724
727
  esac
725
728
  }
726
729
 
@@ -733,18 +736,6 @@ _postman_spec_lint() {
733
736
  esac
734
737
  }
735
738
 
736
- _postman_spec_ai_readiness() {
737
- if [[ "$cur" == -* ]]; then
738
- COMPREPLY=( $(compgen -W "-o --output --export --min-score -h --help" -- "$cur") )
739
- return 0
740
- fi
741
- case "$prev" in
742
- --export)
743
- _postman_filematch '!*.@(json)' "$cur"
744
- return 0 ;;
745
- esac
746
- }
747
-
748
739
  _postman_spec_list() {
749
740
  if [[ "$cur" == -* ]]; then
750
741
  COMPREPLY=( $(compgen -W "-w --workspace --api-key --json -h --help" -- "$cur") )
@@ -854,7 +845,7 @@ _postman_spec_generate() {
854
845
 
855
846
  _postman_spec_generate_collection() {
856
847
  if [[ "$cur" == -* ]]; then
857
- COMPREPLY=( $(compgen -W "-n --name --folder-strategy -w --workspace --api-key -h --help" -- "$cur") )
848
+ COMPREPLY=( $(compgen -W "-n --name --folder-strategy -w --workspace --api-key --force -h --help" -- "$cur") )
858
849
  return 0
859
850
  fi
860
851
  case "$prev" in
@@ -890,6 +881,18 @@ _postman_spec_sync_collection() {
890
881
  esac
891
882
  }
892
883
 
884
+ _postman_spec_delete() {
885
+ if [[ "$cur" == -* ]]; then
886
+ COMPREPLY=( $(compgen -W "-y --yes --api-key -h --help" -- "$cur") )
887
+ return 0
888
+ fi
889
+ case "$prev" in
890
+ --api-key)
891
+ _postman_filematch '!*.@(pem|crt|key)' "$cur"
892
+ return 0 ;;
893
+ esac
894
+ }
895
+
893
896
  _postman_monitor() {
894
897
  if [[ -z "$subcmd" ]]; then
895
898
  if [[ "$cur" == -* ]]; then
@@ -1248,7 +1251,7 @@ _postman_performance() {
1248
1251
 
1249
1252
  _postman_performance_run() {
1250
1253
  if [[ "$cur" == -* ]]; then
1251
- COMPREPLY=( $(compgen -W "-e --environment -g --globals --setup-collection --teardown-collection --vu-count -d --duration -p --load-profile --data-file --ssl-client-cert-list --ssl-client-cert --ssl-client-key --ssl-client-passphrase -k --insecure --ssl-extra-ca-certs --dataset-id --dataset-view-id --dataset-distribution --postman-api-key --output --runner --pass-if --use-mock -h --help" -- "$cur") )
1254
+ COMPREPLY=( $(compgen -W "-e --environment -g --globals --setup-collection --teardown-collection --vu-count -d --duration -p --load-profile --data-file --ssl-client-cert-list --ssl-client-cert --ssl-client-key --ssl-client-passphrase -k --insecure --ssl-extra-ca-certs --dataset-id --dataset-view-id --dataset-distribution --postman-api-key --output --runner --pass-if --use-mock --dataset -h --help" -- "$cur") )
1252
1255
  return 0
1253
1256
  fi
1254
1257
  case "$prev" in
@@ -1267,6 +1270,9 @@ _postman_performance_run() {
1267
1270
  --ssl-extra-ca-certs)
1268
1271
  _postman_filematch '!*.@(pem|crt|key)' "$cur"
1269
1272
  return 0 ;;
1273
+ --dataset)
1274
+ _postman_filematch '!*.@(json)' "$cur"
1275
+ return 0 ;;
1270
1276
  esac
1271
1277
  _postman_filematch '!*.@(json)' "$cur"
1272
1278
  }
@@ -1566,7 +1572,7 @@ _postman_mock_generate() {
1566
1572
 
1567
1573
  _postman_mock_run() {
1568
1574
  if [[ "$cur" == -* ]]; then
1569
- COMPREPLY=( $(compgen -W "-e --environment -g --globals -p --port --api-key -w --workspace --no-history -h --help" -- "$cur") )
1575
+ COMPREPLY=( $(compgen -W "-e --environment -g --globals -p --port --api-key -w --workspace --no-history --output --dataset -h --help" -- "$cur") )
1570
1576
  return 0
1571
1577
  fi
1572
1578
  case "$prev" in
@@ -1579,6 +1585,9 @@ _postman_mock_run() {
1579
1585
  --api-key)
1580
1586
  _postman_filematch '!*.@(pem|crt|key)' "$cur"
1581
1587
  return 0 ;;
1588
+ --dataset)
1589
+ _postman_filematch '!*.@(json)' "$cur"
1590
+ return 0 ;;
1582
1591
  esac
1583
1592
  _postman_filematch '!*.@(json)' "$cur"
1584
1593
  }
@@ -2530,7 +2539,7 @@ _postman_dependency() {
2530
2539
  if [[ "$cur" == -* ]]; then
2531
2540
  COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
2532
2541
  else
2533
- COMPREPLY=( $(compgen -W "add list install update" -- "$cur") )
2542
+ COMPREPLY=( $(compgen -W "add list install update remove" -- "$cur") )
2534
2543
  fi
2535
2544
  return 0
2536
2545
  fi
@@ -2539,6 +2548,7 @@ _postman_dependency() {
2539
2548
  list) _postman_dependency_list ;;
2540
2549
  install) _postman_dependency_install ;;
2541
2550
  update) _postman_dependency_update ;;
2551
+ remove) _postman_dependency_remove ;;
2542
2552
  esac
2543
2553
  }
2544
2554
 
@@ -2578,4 +2588,13 @@ _postman_dependency_update() {
2578
2588
  esac
2579
2589
  }
2580
2590
 
2591
+ _postman_dependency_remove() {
2592
+ if [[ "$cur" == -* ]]; then
2593
+ COMPREPLY=( $(compgen -W "--type -y --yes --json -h --help" -- "$cur") )
2594
+ return 0
2595
+ fi
2596
+ case "$prev" in
2597
+ esac
2598
+ }
2599
+
2581
2600
  complete -F _postman postman
@@ -1,4 +1,4 @@
1
- # Fish completion for Postman CLI (postman v1.65.0)
1
+ # Fish completion for Postman CLI (postman v1.67.0)
2
2
  # Auto-generated by scripts/generate.mjs — DO NOT EDIT
3
3
  # Source: spec/commands.json
4
4
  # https://github.com/yokawasa/postman-cli-completion
@@ -113,17 +113,17 @@ complete -c postman -n '__fish_seen_subcommand_from skills; and __fish_seen_subc
113
113
  complete -c postman -n '__fish_seen_subcommand_from skills; and __fish_seen_subcommand_from update' -r -k -a '(__fish_complete_suffix .json)'
114
114
 
115
115
  # ---------- collection ----------
116
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a new -d 'Scaffold a v3 collection on disk, or create one in a cloud Postman workspace with --workspace.'
117
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a migrate -d 'Migrate a v2.1 collection to the v3 format'
118
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a lint -d 'Run linting on a local v3 collection at the given file or directory path.'
119
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a ai-readiness -d 'Score a Postman collection for AI readiness by ID, local file path, or local-mode directory.'
120
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a get -d 'Fetch a Postman collection in the V3 format and print it.'
121
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a generate -d 'Generate artifacts from a collection.'
122
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a sync -d 'Sync artifacts generated from a collection.'
123
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a request -d 'Add, update, or remove requests in a local v3 collection.'
124
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a folder -d 'Add, update, or remove folders in a local v3 collection.'
125
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a list -d 'List collections: your local project\'s collections by default, or a Postman cloud workspace\'s collections with --workspace.'
126
- complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get generate sync request folder list run' -a run -d 'Initiate a Postman collection run from a given ID or path.'
116
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a new -d 'Scaffold a v3 collection on disk, or create one in a cloud Postman workspace with --workspace.'
117
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a migrate -d 'Migrate a v2.1 collection to the v3 format'
118
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a lint -d 'Run linting on a local v3 collection at the given file or directory path.'
119
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a get -d 'Fetch a Postman collection in the V3 format and print it.'
120
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a publish -d 'Publish a cloud collection\'s documentation (or request Community Manager approval).'
121
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a generate -d 'Generate artifacts from a collection.'
122
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a sync -d 'Sync artifacts generated from a collection.'
123
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a request -d 'Add, update, or remove requests in a local v3 collection.'
124
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a folder -d 'Add, update, or remove folders in a local v3 collection.'
125
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a list -d 'List collections: your local project\'s collections by default, or a Postman cloud workspace\'s collections with --workspace.'
126
+ complete -c postman -n '__postman_using_subcommand collection new migrate lint get publish generate sync request folder list run' -a run -d 'Initiate a Postman collection run from a given ID or path.'
127
127
  complete -c postman -n '__fish_seen_subcommand_from collection' -s h -l help -d 'display help for command'
128
128
  # ---------- collection new ----------
129
129
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from new' -s w -l workspace -d 'Create the collection in a cloud Postman workspace instead of scaffolding it locally. Required when the current directory is not a local Postman workspace.' -x
@@ -140,16 +140,20 @@ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_
140
140
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from lint' -s r -l reporter -d 'Output format: cli (human-readable) or json. (default: "cli")' -x
141
141
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from lint' -s h -l help -d 'display help for command'
142
142
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from lint' -r -k -a '(__fish_complete_suffix .json)'
143
- # ---------- collection ai-readiness ----------
144
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from ai-readiness' -s o -l output -d 'Output format for the results. [choices: "cli", "json", "html"]' -x
145
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from ai-readiness' -l export -d 'Write the report to this file instead of stdout. A directory receives the report under a name derived from the collection. Requires --output html.' -r
146
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from ai-readiness' -l min-score -d 'Exit with a non-zero code if the overall score is below this threshold (0-100).' -x
147
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from ai-readiness' -s h -l help -d 'display help for command'
148
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from ai-readiness' -r -k -a '(__fish_complete_suffix .json)'
149
143
  # ---------- collection get ----------
150
144
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from get' -l api-key -d 'Postman API key (defaults to your `postman login` session)' -r
151
145
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from get' -l json -d 'Print the collection as machine-readable V3 JSON instead of a table'
152
146
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
147
+ # ---------- collection publish ----------
148
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -l target -d 'Where to publish (default: documentation) (default: "documentation")' -x
149
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -l environment -d 'Cloud environment UID to bind to the docs' -r
150
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -l title -d 'SEO title meta tag (max 120 characters)' -x
151
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -l description -d 'SEO description meta tag (max 320 characters)' -x
152
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -l note -d 'Note for Community Managers (request-to-publish only)' -x
153
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -l api-key -d 'Postman API key (defaults to your `postman login` session)' -r
154
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -l json -d 'Machine-readable JSON on stdout (errors on stderr)'
155
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -s h -l help -d 'display help for command'
156
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -r -k -a '(__fish_complete_suffix .json)'
153
157
  # ---------- collection generate ----------
154
158
  complete -c postman -n '__postman_using_subcommand generate spec' -a spec -d 'Generate an OpenAPI specification from a Postman collection.'
155
159
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from generate' -s h -l help -d 'display help for command'
@@ -185,9 +189,10 @@ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_
185
189
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l collection -d 'Target collection: name, directory, id, cloud id, or path (cloud: id only). Required.' -x
186
190
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l folder -d 'Folder to scope the request selector, e.g. "Users/Admin" (local: name/path; cloud: id).' -x
187
191
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l rename -d 'Rename the request (moves its file). Any request type.' -x
188
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l url -d 'Request URL. Any request type.' -x
192
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l url -d 'Request URL; its query string becomes the query parameters. Any request type.' -x
189
193
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l method -d 'HTTP method (http requests only).' -x
190
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l param -d 'Replace query parameters. Repeatable (http requests only). (default: [])' -r
194
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l param -d 'Replace all query parameters and the url query string. Repeatable (http requests only). (default: [])' -r
195
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l clear-params -d 'Remove all query parameters and the url query string (http requests only).'
191
196
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -s d -l body -d 'Request payload (inline, @file, or - for stdin), interpreted by request type. For http, an optional "<type>:" prefix picks the content type: json/text/xml/html/javascript, file:<path>, urlencoded:key=v&k2=v2, or formdata:key=v&file=@path.' -x
192
197
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l variables -d 'GraphQL variables JSON (graphql requests only).' -x
193
198
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from request; and __fish_seen_subcommand_from update' -l description -d 'Request description.' -x
@@ -249,9 +254,9 @@ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_
249
254
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l reporter-json-structure -d '[Optional] Generate JSON report using the Newman schema. By default, JSON reports use the native structure of Postman CLI.'
250
255
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -s n -l iteration-count -d 'Define the number of iterations to run' -x
251
256
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -s d -l iteration-data -d 'Specify a data file to use for iterations (either JSON or CSV)' -r
252
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l iteration-data-dataset -d '[BETA] Path to a .dataset.yaml (local collection) or a cloud dataset id (cloud collection) whose view drives the iteration data. Mutually exclusive with --iteration-data. Requires --iteration-data-view.' -r
253
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l iteration-data-view -d '[BETA] Name or id of the view to execute (within --iteration-data-dataset). The view\'s result set drives one iteration per row.' -x
254
- complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l dataset -d '[BETA] Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to scripts as pm.datasets(<id>). When provided, auto-discovery of .dataset.yaml files from the collection\'s parent repo is disabled. For a cloud collection, scripts address cloud datasets by id via pm.datasets(<id>) (resolved from your `postman login` session). SECURITY: for a cloud collection this does NOT scope access — a script can pm.datasets(<anyId>) for any dataset your session can read. Only run collections you trust against a logged-in cloud session. (default: [])' -r
257
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l iteration-data-dataset -d 'Path to a .dataset.yaml (local collection) or a cloud dataset id (cloud collection) whose view drives the iteration data. Mutually exclusive with --iteration-data. Requires --iteration-data-view.' -r
258
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l iteration-data-view -d 'Name or id of the view to execute (within --iteration-data-dataset). The view\'s result set drives one iteration per row.' -x
259
+ complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l dataset -d 'Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to collection scripts and local mock handlers as pm.datasets(<id>). When provided, auto-discovery of .dataset.yaml files from the collection\'s parent repo is disabled. For a cloud collection, scripts address cloud datasets by id via pm.datasets(<id>) (resolved from your `postman login` session). SECURITY: for a cloud collection this does NOT scope access — a script can pm.datasets(<anyId>) for any dataset your session can read. Only run collections you trust against a logged-in cloud session. (default: [])' -r
255
260
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -s i -d 'Specify the request/folder id, name, or path to run from the collection. Use a path (e.g. "FolderName/RequestName") to disambiguate items with the same name. Can be specified multiple times to run multiple items (default: [])' -x
256
261
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l global-var -d 'Allows the specification of global variables via the command line, in a key=value format' -x
257
262
  complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from run' -l env-var -d 'Allows the specification of environment variables via the command line, in a key=value format (default: [])' -x
@@ -412,14 +417,14 @@ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subc
412
417
  complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from regions' -s h -l help -d 'display help for command'
413
418
 
414
419
  # ---------- spec ----------
415
- complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync' -a lint -d 'Run linting on the given specification by ID or local file path.'
416
- complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync' -a ai-readiness -d 'Score an OpenAPI specification for AI readiness by ID or local file path.'
417
- complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync' -a list -d 'List local spec files under a path, or (no path) a workspace\'s cloud specs.'
418
- complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync' -a get -d 'Read a spec definition, including every file of a multi-file spec.'
419
- complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync' -a file -d 'Add, update, or remove files in a spec (cloud ID or local directory).'
420
- complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync' -a create -d 'Create a new spec in a workspace, or (with path) scaffold a local spec file.'
421
- complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync' -a generate -d 'Generate artifacts from a specification.'
422
- complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync' -a sync -d 'Sync a generated collection with its source specification.'
420
+ complete -c postman -n '__postman_using_subcommand spec lint list get file create generate sync delete' -a lint -d 'Run linting on the given specification by ID or local file path.'
421
+ complete -c postman -n '__postman_using_subcommand spec lint list get file create generate sync delete' -a list -d 'List local spec files under a path, or (no path) a workspace\'s cloud specs.'
422
+ complete -c postman -n '__postman_using_subcommand spec lint list get file create generate sync delete' -a get -d 'Read a spec definition, including every file of a multi-file spec.'
423
+ complete -c postman -n '__postman_using_subcommand spec lint list get file create generate sync delete' -a file -d 'Add, update, or remove files in a spec (cloud ID or local directory).'
424
+ complete -c postman -n '__postman_using_subcommand spec lint list get file create generate sync delete' -a create -d 'Create a new spec in a workspace, or (with path) scaffold a local spec file.'
425
+ complete -c postman -n '__postman_using_subcommand spec lint list get file create generate sync delete' -a generate -d 'Generate artifacts from a specification.'
426
+ complete -c postman -n '__postman_using_subcommand spec lint list get file create generate sync delete' -a sync -d 'Sync a generated collection with its source specification.'
427
+ complete -c postman -n '__postman_using_subcommand spec lint list get file create generate sync delete' -a delete -d 'Delete a spec by its cloud ID or local file path. Cannot be undone.'
423
428
  complete -c postman -n '__fish_seen_subcommand_from spec' -s h -l help -d 'display help for command'
424
429
  # ---------- spec lint ----------
425
430
  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
@@ -428,11 +433,6 @@ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcom
428
433
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -l report-events -d 'Accepted for compatibility; analytics are sent by default'
429
434
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -l no-report-events -d 'Do not send analytics to Postman'
430
435
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -s h -l help -d 'display help for command'
431
- # ---------- spec ai-readiness ----------
432
- 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
433
- complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from ai-readiness' -l export -d 'Write the report to this file instead of stdout. A directory receives the report under a name derived from the specification. Requires --output html.' -r
434
- 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
435
- 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'
436
436
  # ---------- spec list ----------
437
437
  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
438
438
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key' -r
@@ -481,6 +481,7 @@ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcom
481
481
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate; and __fish_seen_subcommand_from collection' -l folder-strategy -d 'Folder strategy: Paths or Tags (default: Paths) (default: "Paths")' -x
482
482
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate; and __fish_seen_subcommand_from collection' -s w -l workspace -d 'Workspace ID (cloud mode)' -x
483
483
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate; and __fish_seen_subcommand_from collection' -l api-key -d 'Postman API key' -r
484
+ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate; and __fish_seen_subcommand_from collection' -l force -d 'Overwrite the collection if one with this name already exists (local mode)'
484
485
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from generate; and __fish_seen_subcommand_from collection' -s h -l help -d 'display help for command'
485
486
  # ---------- spec sync ----------
486
487
  complete -c postman -n '__postman_using_subcommand sync collection' -a collection -d 'Sync a collection from a linked specification (local path or cloud UUID).'
@@ -489,6 +490,10 @@ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcom
489
490
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from sync; and __fish_seen_subcommand_from collection' -l collection-id -d 'Collection ID to sync (required for cloud mode)' -x
490
491
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from sync; and __fish_seen_subcommand_from collection' -l api-key -d 'Postman API key' -r
491
492
  complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from sync; and __fish_seen_subcommand_from collection' -s h -l help -d 'display help for command'
493
+ # ---------- spec delete ----------
494
+ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from delete' -s y -l yes -d 'Delete without asking for confirmation first'
495
+ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from delete' -l api-key -d 'Postman API key, used with a cloud ID (defaults to your `postman login` session)' -r
496
+ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from delete' -s h -l help -d 'display help for command'
492
497
 
493
498
  # ---------- monitor ----------
494
499
  complete -c postman -n '__postman_using_subcommand monitor run create update delete jobs runs list get metrics pause resume' -a run -d 'Invoke a monitor run and display results.'
@@ -745,6 +750,7 @@ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen
745
750
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l runner -d 'Runner to execute the performance test on: local, postman-cloud, or postman-cloud-static-ip (egress from your account region\'s static-IP cluster) (default: local)' -x
746
751
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l pass-if -d 'Pass condition in format: function(metric, value). Functions: less_than, greater_than, less_than_eq, greater_than_eq. Metrics: avg, p90, p95, p99, error_rate, rps. Example: less_than(p95, 500) or less_than(error_rate, 5)' -x
747
752
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l use-mock -d 'Redirect a variable/host to a local code mock or cloud Mock Server (repeatable). Format: "<{{var}}|host> mock|mock-server:<path|id> [scenario]" (default: [])' -x
753
+ complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -l dataset -d 'Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to the handlers of the local mocks started by --use-mock as pm.datasets(<id>). Local runner only. (default: [])' -r
748
754
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
749
755
  complete -c postman -n '__fish_seen_subcommand_from performance; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
750
756
  # ---------- performance list ----------
@@ -990,6 +996,8 @@ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcom
990
996
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -l api-key -d 'Postman API key, used with a Postman cloud id (defaults to your `postman login` session)' -r
991
997
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s w -l workspace -d 'Workspace that owns the run, for recording its start history. Auto-resolved for a Postman cloud id; required to record history for a path.' -x
992
998
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -l no-history -d 'Do not record this run in the mock\'s start history.'
999
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -l output -d 'Live output format: auto (default, human-readable logs) or ndjson (one JSON event per line on stdout, ending with a "summary" event — for CI or other non-interactive use) (default: "auto")' -x
1000
+ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -l dataset -d 'Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to the mock\'s handlers as pm.datasets(<id>). (default: [])' -r
993
1001
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
994
1002
  complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
995
1003
  # ---------- mock push ----------
@@ -1275,7 +1283,7 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
1275
1283
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -l json -d 'Output the full dataset as JSON'
1276
1284
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
1277
1285
  # ---------- dataset query ----------
1278
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s q -l query -d 'SQL query to execute (e.g. "SELECT * FROM source_users LIMIT 10")' -x
1286
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s q -l query -d 'SQL query to execute (e.g. "SELECT * FROM users LIMIT 10")' -x
1279
1287
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s s -l source -d 'Execute directly against a database datasource; without --source, use federated SQLite' -x
1280
1288
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -s p -l param -d 'Bind values to $1, $2, ... in order; pass multiple values after -p or repeat -p' -x
1281
1289
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from query' -l api-key -d 'Postman API key (defaults to the `postman login` session)' -r
@@ -1310,14 +1318,14 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
1310
1318
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
1311
1319
  # ---------- dataset source add ----------
1312
1320
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -s d -l dataset -d 'Dataset to add the source to; positional target is also accepted for v1.45 compatibility' -x
1313
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -s n -l name -d 'Logical name for the source (becomes the SQL table name)' -x
1321
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -s n -l name -d 'Logical name for the source (becomes the SQL table name). Required for every source except a spreadsheet, whose worksheets are each named source_<worksheet>' -x
1314
1322
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l source-id -d 'Override the generated source id (local dataset only)' -x
1315
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l format -d 'Use this format instead of extension/type inference; file contents are not sniffed' -x
1323
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l format -d 'Use this format instead of extension/type inference; file contents are not sniffed. A spreadsheet (xlsx/xls/ods) is added as one source per worksheet, each named source_<worksheet>' -x
1316
1324
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l type -d 'Source kind; local is inferred from --file, jdbc from --driver-jar' -x
1317
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l file -d 'Path to a local CSV/JSON file (absolute or cwd-relative)' -r
1325
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l file -d 'Path to a local CSV/JSON/spreadsheet file (absolute or cwd-relative)' -r
1318
1326
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l ref-only -d 'Reference the file in place; do NOT copy into data_dir (local dataset)'
1319
1327
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l force -d 'When copying, overwrite an existing file at the destination (local dataset)'
1320
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l upload -d 'Cloud dataset only: upload --file as a postmancloudfile source (runs via /exec). Without --upload, --file is registered as a local_filesystem csv/json source read by the local engine.'
1328
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l upload -d 'Cloud dataset only: upload --file as a postmancloudfile source (runs via /exec). Without --upload, --file is registered as a local_filesystem source read by the local engine. Either way a cloud dataset takes csv/json only — add a spreadsheet to a local .dataset.yaml, where each worksheet becomes its own source.'
1321
1329
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l driver-jar -d 'JDBC driver JAR(s). Repeatable, or pass several after one flag' -r
1322
1330
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l driver-class -d 'Driver class. Auto-resolved when the JAR contains exactly one' -x
1323
1331
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from add' -l driver-name -d 'Label for this driver type (defaults to the JAR filename)' -x
@@ -1360,7 +1368,7 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
1360
1368
  # ---------- dataset source update ----------
1361
1369
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -s d -l dataset -d 'Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id' -x
1362
1370
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -s n -l name -d 'Rename the source' -x
1363
- complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l format -d 'Change the format (local dataset only; cloud source formats are immutable)' -x
1371
+ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l format -d 'Change the format (local dataset only; cloud source formats are immutable). A spreadsheet format is not offered here: this command changes the format field alone and cannot pin a worksheet, so the source would not compile. Add the workbook with `dataset source add` instead, which makes one worksheet-pinned source per sheet' -x
1364
1372
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l file -d 'Replace the source file (local dataset only; cloud file replacement is unsupported)' -r
1365
1373
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l ref-only -d 'With --file, reference in place instead of copying (local dataset only)'
1366
1374
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from update' -l force -d 'With --file, overwrite the copied destination (local dataset only)'
@@ -1455,10 +1463,11 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
1455
1463
  complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from jdbc; and __fish_seen_subcommand_from inspect' -s h -l help -d 'display help for command'
1456
1464
 
1457
1465
  # ---------- dependency ----------
1458
- complete -c postman -n '__postman_using_subcommand dependency add list install update' -a add -d 'Add a Postman collection, environment, or mock as a workspace dependency.'
1459
- complete -c postman -n '__postman_using_subcommand dependency add list install update' -a list -d 'List the workspace dependencies declared in .postman/resources.yaml.'
1460
- complete -c postman -n '__postman_using_subcommand dependency add list install update' -a install -d 'Materialise the dependencies declared in .postman/resources.yaml (all, or one).'
1461
- complete -c postman -n '__postman_using_subcommand dependency add list install update' -a update -d 'Refresh declared dependencies to the latest content from their source (all, or one).'
1466
+ complete -c postman -n '__postman_using_subcommand dependency add list install update remove' -a add -d 'Add a Postman collection, environment, or mock as a workspace dependency.'
1467
+ complete -c postman -n '__postman_using_subcommand dependency add list install update remove' -a list -d 'List the workspace dependencies declared in .postman/resources.yaml.'
1468
+ complete -c postman -n '__postman_using_subcommand dependency add list install update remove' -a install -d 'Materialise the dependencies declared in .postman/resources.yaml (all, or one).'
1469
+ complete -c postman -n '__postman_using_subcommand dependency add list install update remove' -a update -d 'Refresh declared dependencies to the latest content from their source (all, or one).'
1470
+ complete -c postman -n '__postman_using_subcommand dependency add list install update remove' -a remove -d 'Remove a workspace dependency and delete its local files.'
1462
1471
  complete -c postman -n '__fish_seen_subcommand_from dependency' -s h -l help -d 'display help for command'
1463
1472
  # ---------- dependency add ----------
1464
1473
  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
@@ -1477,3 +1486,8 @@ complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_
1477
1486
  complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from update' -l type -d 'Only update dependencies of this type (collection, environment, or mock).' -x
1478
1487
  complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from update' -l json -d 'Output the result as JSON.'
1479
1488
  complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from update' -s h -l help -d 'display help for command'
1489
+ # ---------- dependency remove ----------
1490
+ complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from remove' -l type -d 'Only match dependencies of this type (collection, environment, or mock).' -x
1491
+ complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from remove' -s y -l yes -d 'Skip the confirmation prompt (required outside an interactive terminal).'
1492
+ complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from remove' -l json -d 'Output the result as JSON.'
1493
+ complete -c postman -n '__fish_seen_subcommand_from dependency; and __fish_seen_subcommand_from remove' -s h -l help -d 'display help for command'
@@ -1,6 +1,6 @@
1
1
  #compdef postman
2
2
  compdef _postman postman
3
- # Zsh completion for Postman CLI (postman v1.65.0)
3
+ # Zsh completion for Postman CLI (postman v1.67.0)
4
4
  # Auto-generated by scripts/generate.mjs — DO NOT EDIT
5
5
  # Source: spec/commands.json
6
6
  # https://github.com/yokawasa/postman-cli-completion
@@ -207,8 +207,8 @@ _postman_collection() {
207
207
  new) _postman_collection_new ;;
208
208
  migrate) _postman_collection_migrate ;;
209
209
  lint) _postman_collection_lint ;;
210
- ai-readiness) _postman_collection_ai_readiness ;;
211
210
  get) _postman_collection_get ;;
211
+ publish) _postman_collection_publish ;;
212
212
  generate) _postman_collection_generate ;;
213
213
  sync) _postman_collection_sync ;;
214
214
  request) _postman_collection_request ;;
@@ -226,8 +226,8 @@ _postman_collection_commands() {
226
226
  'new:Scaffold a v3 collection on disk, or create one in a cloud Postman workspace with --workspace.'
227
227
  'migrate:Migrate a v2.1 collection to the v3 format'
228
228
  'lint:Run linting on a local v3 collection at the given file or directory path.'
229
- 'ai-readiness:Score a Postman collection for AI readiness by ID, local file path, or local-mode directory.'
230
229
  'get:Fetch a Postman collection in the V3 format and print it.'
230
+ 'publish:Publish a cloud collection'\''s documentation (or request Community Manager approval).'
231
231
  'generate:Generate artifacts from a collection.'
232
232
  'sync:Sync artifacts generated from a collection.'
233
233
  'request:Add, update, or remove requests in a local v3 collection.'
@@ -263,21 +263,25 @@ _postman_collection_lint() {
263
263
  '*:path:_files -g "*.json"'
264
264
  }
265
265
 
266
- _postman_collection_ai_readiness() {
266
+ _postman_collection_get() {
267
267
  _arguments \
268
- '(-o --output)'{-o,--output}'[Output format for the results. \[choices\: "cli", "json", "html"\]]:value' \
269
- '--export[Write the report to this file instead of stdout. A directory receives the report under a name derived from the collection. Requires --output html.]:path:_files -g "*.json"' \
270
- '--min-score[Exit with a non-zero code if the overall score is below this threshold (0-100).]:n' \
268
+ '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
269
+ '--json[Print the collection as machine-readable V3 JSON instead of a table]' \
271
270
  '(-h --help)'{-h,--help}'[display help for command]' \
272
- '*:collectionId/Path:_files -g "*.json"'
271
+ '*:id:'
273
272
  }
274
273
 
275
- _postman_collection_get() {
274
+ _postman_collection_publish() {
276
275
  _arguments \
276
+ '--target[Where to publish (default\: documentation) (default\: "documentation")]:name' \
277
+ '--environment[Cloud environment UID to bind to the docs]:environment-id:_files -g "*.json"' \
278
+ '--title[SEO title meta tag (max 120 characters)]:seo-title' \
279
+ '--description[SEO description meta tag (max 320 characters)]:seo-description' \
280
+ '--note[Note for Community Managers (request-to-publish only)]:text' \
277
281
  '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
278
- '--json[Print the collection as machine-readable V3 JSON instead of a table]' \
282
+ '--json[Machine-readable JSON on stdout (errors on stderr)]' \
279
283
  '(-h --help)'{-h,--help}'[display help for command]' \
280
- '*:id:'
284
+ '*:collection-id:_files -g "*.json"'
281
285
  }
282
286
 
283
287
  _postman_collection_generate() {
@@ -391,9 +395,10 @@ _postman_collection_request_update() {
391
395
  '--collection[Target collection\: name, directory, id, cloud id, or path (cloud\: id only). Required.]:id|name' \
392
396
  '--folder[Folder to scope the request selector, e.g. "Users/Admin" (local\: name/path; cloud\: id).]:id|name|path' \
393
397
  '--rename[Rename the request (moves its file). Any request type.]:name' \
394
- '--url[Request URL. Any request type.]:url' \
398
+ '--url[Request URL; its query string becomes the query parameters. Any request type.]:url' \
395
399
  '--method[HTTP method (http requests only).]:method' \
396
- '--param[Replace query parameters. Repeatable (http requests only). (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
400
+ '--param[Replace all query parameters and the url query string. Repeatable (http requests only). (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
401
+ '--clear-params[Remove all query parameters and the url query string (http requests only).]' \
397
402
  '(-d --body)'{-d,--body}'[Request payload (inline, @file, or - for stdin), interpreted by request type. For http, an optional "<type>\:" prefix picks the content type\: json/text/xml/html/javascript, file\:<path>, urlencoded\:key=v&k2=v2, or formdata\:key=v&file=@path.]:body' \
398
403
  '--variables[GraphQL variables JSON (graphql requests only).]:json' \
399
404
  '--description[Request description.]:text' \
@@ -501,9 +506,9 @@ _postman_collection_run() {
501
506
  '--reporter-json-structure[\[Optional\] Generate JSON report using the Newman schema. By default, JSON reports use the native structure of Postman CLI.]' \
502
507
  '(-n --iteration-count)'{-n,--iteration-count}'[Define the number of iterations to run]:n' \
503
508
  '(-d --iteration-data)'{-d,--iteration-data}'[Specify a data file to use for iterations (either JSON or CSV)]:path:_files -g "*.(json|csv)"' \
504
- '--iteration-data-dataset[\[BETA\] Path to a .dataset.yaml (local collection) or a cloud dataset id (cloud collection) whose view drives the iteration data. Mutually exclusive with --iteration-data. Requires --iteration-data-view.]:pathOrId:_files -g "*.(json|csv)"' \
505
- '--iteration-data-view[\[BETA\] Name or id of the view to execute (within --iteration-data-dataset). The view'\''s result set drives one iteration per row.]:nameOrId' \
506
- '--dataset[\[BETA\] Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to scripts as pm.datasets(<id>). When provided, auto-discovery of .dataset.yaml files from the collection'\''s parent repo is disabled. For a cloud collection, scripts address cloud datasets by id via pm.datasets(<id>) (resolved from your `postman login` session). SECURITY\: for a cloud collection this does NOT scope access — a script can pm.datasets(<anyId>) for any dataset your session can read. Only run collections you trust against a logged-in cloud session. (default\: \[\])]:pathOrDir:_files -g "*.json"' \
509
+ '--iteration-data-dataset[Path to a .dataset.yaml (local collection) or a cloud dataset id (cloud collection) whose view drives the iteration data. Mutually exclusive with --iteration-data. Requires --iteration-data-view.]:pathOrId:_files -g "*.(json|csv)"' \
510
+ '--iteration-data-view[Name or id of the view to execute (within --iteration-data-dataset). The view'\''s result set drives one iteration per row.]:nameOrId' \
511
+ '--dataset[Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to collection scripts and local mock handlers as pm.datasets(<id>). When provided, auto-discovery of .dataset.yaml files from the collection'\''s parent repo is disabled. For a cloud collection, scripts address cloud datasets by id via pm.datasets(<id>) (resolved from your `postman login` session). SECURITY\: for a cloud collection this does NOT scope access — a script can pm.datasets(<anyId>) for any dataset your session can read. Only run collections you trust against a logged-in cloud session. (default\: \[\])]:pathOrDir:_files -g "*.json"' \
507
512
  '-i[Specify the request/folder id, name, or path to run from the collection. Use a path (e.g. "FolderName/RequestName") to disambiguate items with the same name. Can be specified multiple times to run multiple items (default\: \[\])]:id' \
508
513
  '--global-var[Allows the specification of global variables via the command line, in a key=value format]:value' \
509
514
  '--env-var[Allows the specification of environment variables via the command line, in a key=value format (default\: \[\])]:value' \
@@ -829,13 +834,13 @@ _postman_spec() {
829
834
  args)
830
835
  case $words[1] in
831
836
  lint) _postman_spec_lint ;;
832
- ai-readiness) _postman_spec_ai_readiness ;;
833
837
  list) _postman_spec_list ;;
834
838
  get) _postman_spec_get ;;
835
839
  file) _postman_spec_file ;;
836
840
  create) _postman_spec_create ;;
837
841
  generate) _postman_spec_generate ;;
838
842
  sync) _postman_spec_sync ;;
843
+ delete) _postman_spec_delete ;;
839
844
  esac
840
845
  ;;
841
846
  esac
@@ -845,13 +850,13 @@ _postman_spec_commands() {
845
850
  local -a sub
846
851
  sub=(
847
852
  'lint:Run linting on the given specification by ID or local file path.'
848
- 'ai-readiness:Score an OpenAPI specification for AI readiness by ID or local file path.'
849
853
  'list:List local spec files under a path, or (no path) a workspace'\''s cloud specs.'
850
854
  'get:Read a spec definition, including every file of a multi-file spec.'
851
855
  'file:Add, update, or remove files in a spec (cloud ID or local directory).'
852
856
  'create:Create a new spec in a workspace, or (with path) scaffold a local spec file.'
853
857
  'generate:Generate artifacts from a specification.'
854
858
  'sync:Sync a generated collection with its source specification.'
859
+ 'delete:Delete a spec by its cloud ID or local file path. Cannot be undone.'
855
860
  )
856
861
  _describe -t commands 'spec command' sub
857
862
  }
@@ -867,15 +872,6 @@ _postman_spec_lint() {
867
872
  '*:spec:'
868
873
  }
869
874
 
870
- _postman_spec_ai_readiness() {
871
- _arguments \
872
- '(-o --output)'{-o,--output}'[Output format for the results. \[choices\: "cli", "json", "html"\]]:value' \
873
- '--export[Write the report to this file instead of stdout. A directory receives the report under a name derived from the specification. Requires --output html.]:path:_files -g "*.json"' \
874
- '--min-score[Exit with a non-zero code if the overall score is below this threshold (0-100).]:n' \
875
- '(-h --help)'{-h,--help}'[display help for command]' \
876
- '*:spec:'
877
- }
878
-
879
875
  _postman_spec_list() {
880
876
  _arguments \
881
877
  '(-w --workspace)'{-w,--workspace}'[Workspace ID (defaults to .postman/resources.yaml binding)]:id' \
@@ -988,6 +984,7 @@ _postman_spec_generate_collection() {
988
984
  '--folder-strategy[Folder strategy\: Paths or Tags (default\: Paths) (default\: "Paths")]:strategy' \
989
985
  '(-w --workspace)'{-w,--workspace}'[Workspace ID (cloud mode)]:id' \
990
986
  '--api-key[Postman API key]:key:_files -g "*.(pem|crt|key)"' \
987
+ '--force[Overwrite the collection if one with this name already exists (local mode)]' \
991
988
  '(-h --help)'{-h,--help}'[display help for command]' \
992
989
  '*:spec:'
993
990
  }
@@ -1024,6 +1021,14 @@ _postman_spec_sync_collection() {
1024
1021
  '*:spec:'
1025
1022
  }
1026
1023
 
1024
+ _postman_spec_delete() {
1025
+ _arguments \
1026
+ '(-y --yes)'{-y,--yes}'[Delete without asking for confirmation first]' \
1027
+ '--api-key[Postman API key, used with a cloud ID (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1028
+ '(-h --help)'{-h,--help}'[display help for command]' \
1029
+ '*:spec:'
1030
+ }
1031
+
1027
1032
  _postman_monitor() {
1028
1033
  local context state state_descr line
1029
1034
  typeset -A opt_args
@@ -1512,6 +1517,7 @@ _postman_performance_run() {
1512
1517
  '--runner[Runner to execute the performance test on\: local, postman-cloud, or postman-cloud-static-ip (egress from your account region'\''s static-IP cluster) (default\: local)]:runner' \
1513
1518
  '--pass-if[Pass condition in format\: function(metric, value). Functions\: less_than, greater_than, less_than_eq, greater_than_eq. Metrics\: avg, p90, p95, p99, error_rate, rps. Example\: less_than(p95, 500) or less_than(error_rate, 5)]:condition' \
1514
1519
  '--use-mock[Redirect a variable/host to a local code mock or cloud Mock Server (repeatable). Format\: "<{{var}}|host> mock|mock-server\:<path|id> \[scenario\]" (default\: \[\])]:mapping' \
1520
+ '--dataset[Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to the handlers of the local mocks started by --use-mock as pm.datasets(<id>). Local runner only. (default\: \[\])]:pathOrDir:_files -g "*.json"' \
1515
1521
  '(-h --help)'{-h,--help}'[display help for command]' \
1516
1522
  '*:collectionId:_files -g "*.json"'
1517
1523
  }
@@ -1926,6 +1932,8 @@ _postman_mock_run() {
1926
1932
  '--api-key[Postman API key, used with a Postman cloud id (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
1927
1933
  '(-w --workspace)'{-w,--workspace}'[Workspace that owns the run, for recording its start history. Auto-resolved for a Postman cloud id; required to record history for a path.]:id' \
1928
1934
  '--no-history[Do not record this run in the mock'\''s start history.]' \
1935
+ '--output[Live output format\: auto (default, human-readable logs) or ndjson (one JSON event per line on stdout, ending with a "summary" event — for CI or other non-interactive use) (default\: "auto")]:format' \
1936
+ '--dataset[Pass --dataset multiple times to load several .dataset.yaml files (or directories containing them). Each is made available to the mock'\''s handlers as pm.datasets(<id>). (default\: \[\])]:pathOrDir:_files -g "*.json"' \
1929
1937
  '(-h --help)'{-h,--help}'[display help for command]' \
1930
1938
  '*:mockIdOrPath:_files -g "*.json"'
1931
1939
  }
@@ -2700,7 +2708,7 @@ _postman_dataset_get() {
2700
2708
 
2701
2709
  _postman_dataset_query() {
2702
2710
  _arguments \
2703
- '(-q --query)'{-q,--query}'[SQL query to execute (e.g. "SELECT * FROM source_users LIMIT 10")]:sql' \
2711
+ '(-q --query)'{-q,--query}'[SQL query to execute (e.g. "SELECT * FROM users LIMIT 10")]:sql' \
2704
2712
  '(-s --source)'{-s,--source}'[Execute directly against a database datasource; without --source, use federated SQLite]:nameOrIdOrSlug' \
2705
2713
  '(-p --param)'{-p,--param}'[Bind values to $1, $2, ... in order; pass multiple values after -p or repeat -p]:value...' \
2706
2714
  '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
@@ -2774,14 +2782,14 @@ _postman_dataset_source_list() {
2774
2782
  _postman_dataset_source_add() {
2775
2783
  _arguments \
2776
2784
  '(-d --dataset)'{-d,--dataset}'[Dataset to add the source to; positional target is also accepted for v1.45 compatibility]:datasetPathOrId' \
2777
- '(-n --name)'{-n,--name}'[Logical name for the source (becomes the SQL table name)]:name' \
2785
+ '(-n --name)'{-n,--name}'[Logical name for the source (becomes the SQL table name). Required for every source except a spreadsheet, whose worksheets are each named source_<worksheet>]:name' \
2778
2786
  '--source-id[Override the generated source id (local dataset only)]:uuid' \
2779
- '--format[Use this format instead of extension/type inference; file contents are not sniffed]:csv|json|mysql|postgres|sqlserver' \
2787
+ '--format[Use this format instead of extension/type inference; file contents are not sniffed. A spreadsheet (xlsx/xls/ods) is added as one source per worksheet, each named source_<worksheet>]:csv|json|xlsx|xls|ods|jdbc|mysql|postgres|sqlserver' \
2780
2788
  '--type[Source kind; local is inferred from --file, jdbc from --driver-jar]:local|mysql|postgresql|sqlserver|jdbc' \
2781
- '--file[Path to a local CSV/JSON file (absolute or cwd-relative)]:path:_files -g "*.json"' \
2789
+ '--file[Path to a local CSV/JSON/spreadsheet file (absolute or cwd-relative)]:path:_files -g "*.json"' \
2782
2790
  '--ref-only[Reference the file in place; do NOT copy into data_dir (local dataset)]' \
2783
2791
  '--force[When copying, overwrite an existing file at the destination (local dataset)]' \
2784
- '--upload[Cloud dataset only\: upload --file as a postmancloudfile source (runs via /exec). Without --upload, --file is registered as a local_filesystem csv/json source read by the local engine.]' \
2792
+ '--upload[Cloud dataset only\: upload --file as a postmancloudfile source (runs via /exec). Without --upload, --file is registered as a local_filesystem source read by the local engine. Either way a cloud dataset takes csv/json only — add a spreadsheet to a local .dataset.yaml, where each worksheet becomes its own source.]' \
2785
2793
  '--driver-jar[JDBC driver JAR(s). Repeatable, or pass several after one flag]:path...:_files -g "*.json"' \
2786
2794
  '--driver-class[Driver class. Auto-resolved when the JAR contains exactly one]:fqcn' \
2787
2795
  '--driver-name[Label for this driver type (defaults to the JAR filename)]:label' \
@@ -2832,7 +2840,7 @@ _postman_dataset_source_update() {
2832
2840
  _arguments \
2833
2841
  '(-d --dataset)'{-d,--dataset}'[Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
2834
2842
  '(-n --name)'{-n,--name}'[Rename the source]:name' \
2835
- '--format[Change the format (local dataset only; cloud source formats are immutable)]:csv|json|mysql|postgres|sqlserver' \
2843
+ '--format[Change the format (local dataset only; cloud source formats are immutable). A spreadsheet format is not offered here\: this command changes the format field alone and cannot pin a worksheet, so the source would not compile. Add the workbook with `dataset source add` instead, which makes one worksheet-pinned source per sheet]:csv|json|jdbc|mysql|postgres|sqlserver' \
2836
2844
  '--file[Replace the source file (local dataset only; cloud file replacement is unsupported)]:path:_files -g "*.json"' \
2837
2845
  '--ref-only[With --file, reference in place instead of copying (local dataset only)]' \
2838
2846
  '--force[With --file, overwrite the copied destination (local dataset only)]' \
@@ -3013,6 +3021,7 @@ _postman_dependency() {
3013
3021
  list) _postman_dependency_list ;;
3014
3022
  install) _postman_dependency_install ;;
3015
3023
  update) _postman_dependency_update ;;
3024
+ remove) _postman_dependency_remove ;;
3016
3025
  esac
3017
3026
  ;;
3018
3027
  esac
@@ -3025,6 +3034,7 @@ _postman_dependency_commands() {
3025
3034
  'list:List the workspace dependencies declared in .postman/resources.yaml.'
3026
3035
  'install:Materialise the dependencies declared in .postman/resources.yaml (all, or one).'
3027
3036
  'update:Refresh declared dependencies to the latest content from their source (all, or one).'
3037
+ 'remove:Remove a workspace dependency and delete its local files.'
3028
3038
  )
3029
3039
  _describe -t commands 'dependency command' sub
3030
3040
  }
@@ -3061,6 +3071,15 @@ _postman_dependency_update() {
3061
3071
  '*:nameOrId:'
3062
3072
  }
3063
3073
 
3074
+ _postman_dependency_remove() {
3075
+ _arguments \
3076
+ '--type[Only match dependencies of this type (collection, environment, or mock).]:type' \
3077
+ '(-y --yes)'{-y,--yes}'[Skip the confirmation prompt (required outside an interactive terminal).]' \
3078
+ '--json[Output the result as JSON.]' \
3079
+ '(-h --help)'{-h,--help}'[display help for command]' \
3080
+ '*:nameOrId:'
3081
+ }
3082
+
3064
3083
  # When loaded via fpath + compinit, the file body becomes the function body of
3065
3084
  # `_postman`. In that case `funcstack[1]` is `_postman` and we must actually
3066
3085
  # invoke the completion. When sourced directly, this is a no-op — `_postman`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "postman-cli-completion",
3
- "version": "1.65.0",
3
+ "version": "1.67.0",
4
4
  "description": "Shell completions for the Postman CLI (zsh, bash, fish)",
5
5
  "type": "module",
6
6
  "bin": {