postman-cli-completion 1.66.0 → 1.67.0

package/completions/bash/postman.bash

@@ -1,4 +1,4 @@
-# Bash completion for Postman CLI (postman v1.66.0)
+# Bash completion for Postman CLI (postman v1.67.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -179,7 +179,7 @@ _postman_collection() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "new migrate lint ai-readiness get generate sync request folder list run" -- "$cur") )
+      COMPREPLY=( $(compgen -W "new migrate lint get publish generate sync request folder list run" -- "$cur") )
     fi
     return 0
   fi
@@ -187,8 +187,8 @@ _postman_collection() {
     new) _postman_collection_new ;;
     migrate) _postman_collection_migrate ;;
     lint) _postman_collection_lint ;;
-    ai-readiness) _postman_collection_ai_readiness ;;
     get) _postman_collection_get ;;
+    publish) _postman_collection_publish ;;
     generate) _postman_collection_generate ;;
     sync) _postman_collection_sync ;;
     request) _postman_collection_request ;;
@@ -230,29 +230,32 @@ _postman_collection_lint() {
   _postman_filematch '!*.@(json)' "$cur"
 }
 
-_postman_collection_ai_readiness() {
+_postman_collection_get() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-o --output --export --min-score -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "--api-key --json -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
-    --export)
-      _postman_filematch '!*.@(json)' "$cur"
+    --api-key)
+      _postman_filematch '!*.@(pem|crt|key)' "$cur"
       return 0 ;;
   esac
-  _postman_filematch '!*.@(json)' "$cur"
 }
 
-_postman_collection_get() {
+_postman_collection_publish() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--api-key --json -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "--target --environment --title --description --note --api-key --json -h --help" -- "$cur") )
     return 0
   fi
   case "$prev" in
+    --environment)
+      _postman_filematch '!*.@(json)' "$cur"
+      return 0 ;;
     --api-key)
       _postman_filematch '!*.@(pem|crt|key)' "$cur"
       return 0 ;;
   esac
+  _postman_filematch '!*.@(json)' "$cur"
 }
 
 _postman_collection_generate() {
@@ -336,7 +339,7 @@ _postman_collection_request_add() {
 
 _postman_collection_request_update() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "--collection --folder --rename --url --method --param -d --body --variables --description --headers --auth --scripts -w --workspace --type --json -h --help" -- "$cur") )
+    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") )
     return 0
   fi
   case "$prev" in
@@ -708,13 +711,12 @@ _postman_spec() {
     if [[ "$cur" == -* ]]; then
       COMPREPLY=( $(compgen -W "-h --help" -- "$cur") )
     else
-      COMPREPLY=( $(compgen -W "lint ai-readiness list get file create generate sync delete" -- "$cur") )
+      COMPREPLY=( $(compgen -W "lint list get file create generate sync delete" -- "$cur") )
     fi
     return 0
   fi
   case "$subcmd" in
     lint) _postman_spec_lint ;;
-    ai-readiness) _postman_spec_ai_readiness ;;
     list) _postman_spec_list ;;
     get) _postman_spec_get ;;
     file) _postman_spec_file ;;
@@ -734,18 +736,6 @@ _postman_spec_lint() {
   esac
 }
 
-_postman_spec_ai_readiness() {
-  if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-o --output --export --min-score -h --help" -- "$cur") )
-    return 0
-  fi
-  case "$prev" in
-    --export)
-      _postman_filematch '!*.@(json)' "$cur"
-      return 0 ;;
-  esac
-}
-
 _postman_spec_list() {
   if [[ "$cur" == -* ]]; then
     COMPREPLY=( $(compgen -W "-w --workspace --api-key --json -h --help" -- "$cur") )
@@ -1582,7 +1572,7 @@ _postman_mock_generate() {
 
 _postman_mock_run() {
   if [[ "$cur" == -* ]]; then
-    COMPREPLY=( $(compgen -W "-e --environment -g --globals -p --port --api-key -w --workspace --no-history --dataset -h --help" -- "$cur") )
+    COMPREPLY=( $(compgen -W "-e --environment -g --globals -p --port --api-key -w --workspace --no-history --output --dataset -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.66.0)
+# Fish completion for Postman CLI (postman v1.67.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -113,17 +113,17 @@ complete -c postman -n '__fish_seen_subcommand_from skills; and __fish_seen_subc
 complete -c postman -n '__fish_seen_subcommand_from skills; and __fish_seen_subcommand_from update' -r -k -a '(__fish_complete_suffix .json)'
 
 # ---------- collection ----------
-complete -c postman -n '__postman_using_subcommand collection new migrate lint ai-readiness get 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.'
-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'
-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.'
-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.'
-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.'
-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.'
-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.'
-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.'
-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.'
-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.'
-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.'
+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.'
+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'
+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.'
+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.'
+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).'
+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.'
+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.'
+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.'
+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.'
+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.'
+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.'
 complete -c postman -n '__fish_seen_subcommand_from collection' -s h -l help -d 'display help for command'
 # ---------- collection new ----------
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from new' -s w -l workspace -d 'Create the collection in a cloud Postman workspace instead of scaffolding it locally. Required when the current directory is not a local Postman workspace.' -x
@@ -140,16 +140,20 @@ 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 lint' -s r -l reporter -d 'Output format: cli (human-readable) or json. (default: "cli")' -x
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from lint' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from lint' -r -k -a '(__fish_complete_suffix .json)'
-# ---------- collection ai-readiness ----------
-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
-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
-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
-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'
-complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from ai-readiness' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- collection get ----------
 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
 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'
 complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
+# ---------- collection publish ----------
+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
+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
+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
+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
+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
+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
+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)'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -s h -l help -d 'display help for command'
+complete -c postman -n '__fish_seen_subcommand_from collection; and __fish_seen_subcommand_from publish' -r -k -a '(__fish_complete_suffix .json)'
 # ---------- collection generate ----------
 complete -c postman -n '__postman_using_subcommand generate spec' -a spec -d 'Generate an OpenAPI specification from a Postman collection.'
 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_
 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
 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
 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
-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
+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
 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
-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
+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
+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).'
 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
 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
 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_
 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.'
 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
 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
-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
-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
-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 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
+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
+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
+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
 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
 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
 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,15 +417,14 @@ complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subc
 complete -c postman -n '__fish_seen_subcommand_from runner; and __fish_seen_subcommand_from regions' -s h -l help -d 'display help for command'
 
 # ---------- spec ----------
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync delete' -a lint -d 'Run linting on the given specification by ID or local file path.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync delete' -a ai-readiness -d 'Score an OpenAPI specification for AI readiness by ID or local file path.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync delete' -a list -d 'List local spec files under a path, or (no path) a workspace\'s cloud specs.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync delete' -a get -d 'Read a spec definition, including every file of a multi-file spec.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync delete' -a file -d 'Add, update, or remove files in a spec (cloud ID or local directory).'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness 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.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync delete' -a generate -d 'Generate artifacts from a specification.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync delete' -a sync -d 'Sync a generated collection with its source specification.'
-complete -c postman -n '__postman_using_subcommand spec lint ai-readiness list get file create generate sync delete' -a delete -d 'Delete a spec by its cloud ID or local file path. Cannot be undone.'
+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.'
+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.'
+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.'
+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).'
+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.'
+complete -c postman -n '__postman_using_subcommand spec lint list get file create generate sync delete' -a generate -d 'Generate artifacts from a specification.'
+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.'
+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.'
 complete -c postman -n '__fish_seen_subcommand_from spec' -s h -l help -d 'display help for command'
 # ---------- spec lint ----------
 complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -s f -l fail-severity -d 'Results of this level or above will trigger a failure exit code. [choices: "error", "warning", "info", "hint"] (default: "ERROR")' -x
@@ -429,11 +433,6 @@ complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcom
 complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -l report-events -d 'Accepted for compatibility; analytics are sent by default'
 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'
 complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from lint' -s h -l help -d 'display help for command'
-# ---------- spec ai-readiness ----------
-complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from ai-readiness' -s o -l output -d 'Output format for the results. [choices: "cli", "json", "html"]' -x
-complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from ai-readiness' -l 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
-complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from ai-readiness' -l min-score -d 'Exit with a non-zero code if the overall score is below this threshold (0-100).' -x
-complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from ai-readiness' -s h -l help -d 'display help for command'
 # ---------- spec list ----------
 complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from list' -s w -l workspace -d 'Workspace ID (defaults to .postman/resources.yaml binding)' -x
 complete -c postman -n '__fish_seen_subcommand_from spec; and __fish_seen_subcommand_from list' -l api-key -d 'Postman API key' -r
@@ -997,6 +996,7 @@ complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcom
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -l api-key -d 'Postman API key, used with a Postman cloud id (defaults to your `postman login` session)' -r
 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
 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.'
+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
 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
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -s h -l help -d 'display help for command'
 complete -c postman -n '__fish_seen_subcommand_from mock; and __fish_seen_subcommand_from run' -r -k -a '(__fish_complete_suffix .json)'
@@ -1283,7 +1283,7 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -l json -d 'Output the full dataset as JSON'
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from get' -s h -l help -d 'display help for command'
 # ---------- dataset query ----------
-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
+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
 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
 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
 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
@@ -1318,14 +1318,14 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
 complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_subcommand_from source; and __fish_seen_subcommand_from list' -s h -l help -d 'display help for command'
 # ---------- dataset source add ----------
 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
-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
+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
 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
-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
+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
 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
-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
+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
 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)'
 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)'
-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.'
+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.'
 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
 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
 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
@@ -1368,7 +1368,7 @@ complete -c postman -n '__fish_seen_subcommand_from dataset; and __fish_seen_sub
 # ---------- dataset source update ----------
 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
 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
-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
+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
 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
 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)'
 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)'

package/completions/zsh/_postman

@@ -1,6 +1,6 @@
 #compdef postman
 compdef _postman postman
-# Zsh completion for Postman CLI (postman v1.66.0)
+# Zsh completion for Postman CLI (postman v1.67.0)
 # Auto-generated by scripts/generate.mjs — DO NOT EDIT
 # Source: spec/commands.json
 # https://github.com/yokawasa/postman-cli-completion
@@ -207,8 +207,8 @@ _postman_collection() {
         new) _postman_collection_new ;;
         migrate) _postman_collection_migrate ;;
         lint) _postman_collection_lint ;;
-        ai-readiness) _postman_collection_ai_readiness ;;
         get) _postman_collection_get ;;
+        publish) _postman_collection_publish ;;
         generate) _postman_collection_generate ;;
         sync) _postman_collection_sync ;;
         request) _postman_collection_request ;;
@@ -226,8 +226,8 @@ _postman_collection_commands() {
     'new:Scaffold a v3 collection on disk, or create one in a cloud Postman workspace with --workspace.'
     'migrate:Migrate a v2.1 collection to the v3 format'
     'lint:Run linting on a local v3 collection at the given file or directory path.'
-    'ai-readiness:Score a Postman collection for AI readiness by ID, local file path, or local-mode directory.'
     'get:Fetch a Postman collection in the V3 format and print it.'
+    'publish:Publish a cloud collection'\''s documentation (or request Community Manager approval).'
     'generate:Generate artifacts from a collection.'
     'sync:Sync artifacts generated from a collection.'
     'request:Add, update, or remove requests in a local v3 collection.'
@@ -263,21 +263,25 @@ _postman_collection_lint() {
     '*:path:_files -g "*.json"'
 }
 
-_postman_collection_ai_readiness() {
+_postman_collection_get() {
   _arguments \
-    '(-o --output)'{-o,--output}'[Output format for the results. \[choices\: "cli", "json", "html"\]]:value' \
-    '--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"' \
-    '--min-score[Exit with a non-zero code if the overall score is below this threshold (0-100).]:n' \
+    '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
+    '--json[Print the collection as machine-readable V3 JSON instead of a table]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:collectionId/Path:_files -g "*.json"'
+    '*:id:'
 }
 
-_postman_collection_get() {
+_postman_collection_publish() {
   _arguments \
+    '--target[Where to publish (default\: documentation) (default\: "documentation")]:name' \
+    '--environment[Cloud environment UID to bind to the docs]:environment-id:_files -g "*.json"' \
+    '--title[SEO title meta tag (max 120 characters)]:seo-title' \
+    '--description[SEO description meta tag (max 320 characters)]:seo-description' \
+    '--note[Note for Community Managers (request-to-publish only)]:text' \
     '--api-key[Postman API key (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
-    '--json[Print the collection as machine-readable V3 JSON instead of a table]' \
+    '--json[Machine-readable JSON on stdout (errors on stderr)]' \
     '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:id:'
+    '*:collection-id:_files -g "*.json"'
 }
 
 _postman_collection_generate() {
@@ -391,9 +395,10 @@ _postman_collection_request_update() {
     '--collection[Target collection\: name, directory, id, cloud id, or path (cloud\: id only). Required.]:id|name' \
     '--folder[Folder to scope the request selector, e.g. "Users/Admin" (local\: name/path; cloud\: id).]:id|name|path' \
     '--rename[Rename the request (moves its file). Any request type.]:name' \
-    '--url[Request URL. Any request type.]:url' \
+    '--url[Request URL; its query string becomes the query parameters. Any request type.]:url' \
     '--method[HTTP method (http requests only).]:method' \
-    '--param[Replace query parameters. Repeatable (http requests only). (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
+    '--param[Replace all query parameters and the url query string. Repeatable (http requests only). (default\: \[\])]:key\:value:_files -g "*.(pem|crt|key)"' \
+    '--clear-params[Remove all query parameters and the url query string (http requests only).]' \
     '(-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' \
     '--variables[GraphQL variables JSON (graphql requests only).]:json' \
     '--description[Request description.]:text' \
@@ -501,9 +506,9 @@ _postman_collection_run() {
     '--reporter-json-structure[\[Optional\] Generate JSON report using the Newman schema. By default, JSON reports use the native structure of Postman CLI.]' \
     '(-n --iteration-count)'{-n,--iteration-count}'[Define the number of iterations to run]:n' \
     '(-d --iteration-data)'{-d,--iteration-data}'[Specify a data file to use for iterations (either JSON or CSV)]:path:_files -g "*.(json|csv)"' \
-    '--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)"' \
-    '--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' \
-    '--dataset[\[BETA\] 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"' \
+    '--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)"' \
+    '--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' \
+    '--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"' \
     '-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' \
     '--global-var[Allows the specification of global variables via the command line, in a key=value format]:value' \
     '--env-var[Allows the specification of environment variables via the command line, in a key=value format (default\: \[\])]:value' \
@@ -829,7 +834,6 @@ _postman_spec() {
     args)
       case $words[1] in
         lint) _postman_spec_lint ;;
-        ai-readiness) _postman_spec_ai_readiness ;;
         list) _postman_spec_list ;;
         get) _postman_spec_get ;;
         file) _postman_spec_file ;;
@@ -846,7 +850,6 @@ _postman_spec_commands() {
   local -a sub
   sub=(
     'lint:Run linting on the given specification by ID or local file path.'
-    'ai-readiness:Score an OpenAPI specification for AI readiness by ID or local file path.'
     'list:List local spec files under a path, or (no path) a workspace'\''s cloud specs.'
     'get:Read a spec definition, including every file of a multi-file spec.'
     'file:Add, update, or remove files in a spec (cloud ID or local directory).'
@@ -869,15 +872,6 @@ _postman_spec_lint() {
     '*:spec:'
 }
 
-_postman_spec_ai_readiness() {
-  _arguments \
-    '(-o --output)'{-o,--output}'[Output format for the results. \[choices\: "cli", "json", "html"\]]:value' \
-    '--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"' \
-    '--min-score[Exit with a non-zero code if the overall score is below this threshold (0-100).]:n' \
-    '(-h --help)'{-h,--help}'[display help for command]' \
-    '*:spec:'
-}
-
 _postman_spec_list() {
   _arguments \
     '(-w --workspace)'{-w,--workspace}'[Workspace ID (defaults to .postman/resources.yaml binding)]:id' \
@@ -1938,6 +1932,7 @@ _postman_mock_run() {
     '--api-key[Postman API key, used with a Postman cloud id (defaults to your `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
     '(-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' \
     '--no-history[Do not record this run in the mock'\''s start history.]' \
+    '--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' \
     '--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"' \
     '(-h --help)'{-h,--help}'[display help for command]' \
     '*:mockIdOrPath:_files -g "*.json"'
@@ -2713,7 +2708,7 @@ _postman_dataset_get() {
 
 _postman_dataset_query() {
   _arguments \
-    '(-q --query)'{-q,--query}'[SQL query to execute (e.g. "SELECT * FROM source_users LIMIT 10")]:sql' \
+    '(-q --query)'{-q,--query}'[SQL query to execute (e.g. "SELECT * FROM users LIMIT 10")]:sql' \
     '(-s --source)'{-s,--source}'[Execute directly against a database datasource; without --source, use federated SQLite]:nameOrIdOrSlug' \
     '(-p --param)'{-p,--param}'[Bind values to $1, $2, ... in order; pass multiple values after -p or repeat -p]:value...' \
     '--api-key[Postman API key (defaults to the `postman login` session)]:key:_files -g "*.(pem|crt|key)"' \
@@ -2787,14 +2782,14 @@ _postman_dataset_source_list() {
 _postman_dataset_source_add() {
   _arguments \
     '(-d --dataset)'{-d,--dataset}'[Dataset to add the source to; positional target is also accepted for v1.45 compatibility]:datasetPathOrId' \
-    '(-n --name)'{-n,--name}'[Logical name for the source (becomes the SQL table name)]:name' \
+    '(-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' \
     '--source-id[Override the generated source id (local dataset only)]:uuid' \
-    '--format[Use this format instead of extension/type inference; file contents are not sniffed]:csv|json|mysql|postgres|sqlserver' \
+    '--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' \
     '--type[Source kind; local is inferred from --file, jdbc from --driver-jar]:local|mysql|postgresql|sqlserver|jdbc' \
-    '--file[Path to a local CSV/JSON file (absolute or cwd-relative)]:path:_files -g "*.json"' \
+    '--file[Path to a local CSV/JSON/spreadsheet file (absolute or cwd-relative)]:path:_files -g "*.json"' \
     '--ref-only[Reference the file in place; do NOT copy into data_dir (local dataset)]' \
     '--force[When copying, overwrite an existing file at the destination (local dataset)]' \
-    '--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.]' \
+    '--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.]' \
     '--driver-jar[JDBC driver JAR(s). Repeatable, or pass several after one flag]:path...:_files -g "*.json"' \
     '--driver-class[Driver class. Auto-resolved when the JAR contains exactly one]:fqcn' \
     '--driver-name[Label for this driver type (defaults to the JAR filename)]:label' \
@@ -2845,7 +2840,7 @@ _postman_dataset_source_update() {
   _arguments \
     '(-d --dataset)'{-d,--dataset}'[Dataset the source belongs to — a local .dataset.yaml path or a cloud dataset id]:datasetPathOrId' \
     '(-n --name)'{-n,--name}'[Rename the source]:name' \
-    '--format[Change the format (local dataset only; cloud source formats are immutable)]:csv|json|mysql|postgres|sqlserver' \
+    '--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' \
     '--file[Replace the source file (local dataset only; cloud file replacement is unsupported)]:path:_files -g "*.json"' \
     '--ref-only[With --file, reference in place instead of copying (local dataset only)]' \
     '--force[With --file, overwrite the copied destination (local dataset only)]' \

package/package.json

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